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ABOUT THIS GUIDE 
Purpose 


We’ve designed this 


GuMe to 


nr at? i ^ n 
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order to write application software to run on 
Z8Q-based microcomputers under the TurboDOS 
operating system. This document explains the 
theory of operation of each internal facility 
of TurboDOS. It also describes in detail 
each TurboDOS function that may be called by 
an application program. 


Assumptions In writing this guide, we've assumed that you 

are an experienced assembly-language program¬ 
mer writing application programs for the Z80 
TurboDOS environment. We've also assumed you 
have read the Tur boDOS 1.4 User's Guide , and 
are therefore familiar with the commands and 
external features of TurboDOS. 


Organization 


This guide starts with a section that 
describes the fundamentals of the TurboDOS 
environment, with emphasis on the organiza¬ 
tion of memory and the interface and flow of 
control between application programs and the 
operating system. 


The next two sections explain TurboDOS inter¬ 
nals in more detail. One describes the file 
system, and the other describes serial I/O. 


There are two reference sections that explain 
each TurboDOS function call in detail. One 
section describes CP/M-compatible functions 
supported by TurboDOS, while the other 
describes functions unique to TurboDOS. 

Appendices describe a debugging tool called 
MONITOR, and summarize the function calls in 
condensed tabular form. Finally, there is an 
alphabetical index. 
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Related Documents In addition to this guide, you might be 

interested in four other related documents: 


• TurboDOS 1.4 User’s Guide 
. TurboDOS LA _Z8Q I mple m entor's Guide 


. ImJaflPQS LA MM Progra m mer's Guide 
. £_ux b .Q. PQ S 1*1 MM Implementor's Guide 


You should read the U ser's Guide before you 
start into this document. It introduces the 
external features and facilities of TurboDOS, 
and describes each TurboDOS command in de¬ 
tail . 


You'll need the Z80 Imp le m entor*s Guide if 
you are adapting TurboDOS to a new hardware 
configuration. It explains the system gene¬ 
ration and OEM distribution procedures, and 
also describes how to implement hardware- 
dependent driver modules. 

You'll need the 8086 guides if you are pro¬ 
gramming or configuring a TurboDOS system 
that uses 8086-family microprocessors. 
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FUNDAMENTALS This section introduces you to the TurboDOS 

environment. Emphasis is given to the orga¬ 
nization of memory, and to the interface and 
flow of control between application programs 
and the operating system. Subsequent sec¬ 
tions describe the file system and other 
facilities in detail. 


Memory Organization The resident portion of TurboDOS typically 

occupies between 12K and 24K of memory, de¬ 
pending on configuration. An additional 2K 
to 8K (or more) may be devoted to disk buf¬ 
fers, and another IK or so to print queues, 
file interlocks, and various other items of 
dynamic working storage. A 256-byte "Base 
Page" is reserved at the bottom of memory for 
communications between TurboDOS and applica¬ 
tion programs. 

The remaining memory space available for use 
by commands and application programs is known 
as the "Transient Program Area" (TPA). 

Z80 TurboDOS supports two alternative memory 
organization schemes, depending on whether or 
not bank-switched memory is available. 


Non-Banked Memory A non-banked Z80 configuration is limited by 

hardware constraints to a maximum of 64K of 
memory. TurboDOS resides in the topmost 
portion of memory, and allocates its disk 
buffers and other dynamic space requirements 
immediately below itself. The TPA occupies 
the lower portion of memory, as shown in the 
diagram on the next page. 
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Non-Banked Memory FFFFH 

(Continued) 


0100H 
0000H 

While a transient program is running in the 
TPA, TurboDOS may need to acquire additional 
dynamic space. Consequently, a small "memory 
reserve" area (typcially IK or less) is pro¬ 
vided to protect the TPA from encroachment as 
dynamic space grows. If this reserve is 
exhausted and TurboDOS requires still more 
dynamic space, then the transient program is 
aborted with the message "Program terminated 
due to insufficient memory". 

In non-banked systems, the TPA is limited by 
the size of TurboDOS, its disk buffers, and 
other dynamic space. If more TPA is needed, 
the size of the disk buffer area may be 
decreased using the BUFFERS command or a 
system call. However, this is effective only 
when the system is completely quiescent (no 
files open, no print jobs queued, etc.) so 
that there is no dynamic space allocated 
below the disk buffers. 
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Banked Memory 


A banked Z80 configuration permits more than 
64K of memory by providing two memory banks, 
only one of which may be active at a time. 
TurboDOS resides in bank 0 along with its 

✓q ^ L- k,-< -c -e ^ ^ ~ a- u ~ ~ ^ ^ ~ „ „uji^ - 

wioft uuiiclo emu uliicl uyaaiux^ spacer wane a 

63K Transient Program Area occupies bank 1. 


An area of common (non-switched) memory must 
be provided at the top of memory. Ideally, 
it should be IK, permitting each memory bank 
to be 63K. However, hardware design often 
dictates that the common area be larger, 
often as big as 16K. A large common area 
reduces the memory available for TurboDOS, 
disk buffers and dynamic space, but does not 
reduce the 63K TPA size: 


(Common) 


FFFFH i 

1 

1 

TurboDOS Bank Mgr. 

1 

1 IK 

1 


FBFFH 1 


1 

1 

1 

_ Transient Program 

1 

63K 
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_ Area (Continued) 

1 
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! 
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1 

l 
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i 
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— 

l 
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Program Interface TurboDOS supports 110 distinct functions that 

may be invoked by an application program. 
Functions are provided for file management, 
console input/output, printing and spooling, 
and various other TurboDOS facilities. The 
last half of this guide is largely devoted to 
describing each of these functions in detail. 

Functions supported by TurboDOS fall into two 
categories: CP/M-compatible functions, and 
TurboDOS-unique functions. We will refer to 
them as "C-functions" and "T-functions", 
respectively* TurboDOS supports 6 6 C-f unc¬ 
tions and 44 T-Functions. 


C-Functions 


To invoke a C-function, a program executes a 
CALL to location 0005H in the Base Page with 
a function number in the C-register. Turbo¬ 
DOS supports all BDOS functions of CP/M 2.2: 


0 System Reset 

1 Console Input 

2 Console Output 
3*Raw Console Input 
4*Raw Console Output 

5 List Output 

6 Direct Console I/O 

7 Get I/O Byte 

8 Set I/O Byte 

9 Print String 

10 Read Cons. Buffer 

11 Get Console Status 

12 Return Version 

13 Reset Disk System 

14 Select Disk 

15 Open File 

16 Close File 

17 Search for First 

18 Search for Next 

19 Delete File 


20 Read Sequential 

21 Write Sequential 

22 Make File 

23 Rename File 

24 Return Login Vector 

25 Return Current Disk 

26 Set DMA Address 
27*Get ALV Address 

28 Write Protect Disk 

29 Get R/O Vector 

30 Set File Attributes 

31 Get DPB Address 

32 Get/Set User Number 

33 Read Random 

34 Write Random 

35 Compute File Size 

36 Set Random Record 

37 Reset Drive 
(38-39 reserved) 

40*Write Random 0-Fill 
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C-Functions 

(Continued) 


These TurboDOS C-functions are compatible 
with the corresponding functions in CP/M 2.2 
except for the four functions marked with an 
asterisk. C-functions 3 and 4 are compatible 
with MP/M II rather than CP/M. C-function 40 
is synonymous with 34. C-function 27 per¬ 
forms no operation in TurboDOS, but this 
function affects only the STAT utility of 
CP/M (not normally used with TurboDOS). 


In addition to BDOS functions 0-40 supported 
by CP/M 2.2, a number of additional functions 
have been implemented in CP/M 3 and MP/M II. 
TurboDOS provides compatible C-functions for 
certain of these functions: 


42 Lock Record 

43 Unlock Record 

44 Set Multi-Sector 

46 Get Free Space 

47 Chain to Program 

104 Set Date/Time 

105 Get Date/Time 

107 Return Serial No. 

108 Get/Set Rtn Code 

110 Get/Set Delimiter 

111 Print Block 

112 List Block 

134 Make Queue 

135 Open Queue 

However, the following rarely-used CP/M 3 
functions are not implemented, and perform no 


function in TurboDOS: 




41 

Test and Write 

99 

Truncate 

File 

45 

Set Error Mode 

100 

Set Dir. 

Label 

48 

Flush Buffers 

101 

Get Dir. 

Label 

49 

Get/Set SCB 

102 

Read Passw'd Mode 

50 

Direct BIOS Call 

103 

Write File XFCB 

59 

Load Overlay 

106 

Set Def. 

Passw 1 d 

60 

Call RSX 

109 

Get/Set 

Cons Mode 

98 

Free Blocks 





136 Delete Queue 

137 Read Queue 

138 Cond. Read Queue 

139 Write Queue 

140 Cond. Write Queue 

141 Delay 

142 Dispatch 

143 Terminate Process 

152 Parse Filename 

153 Get Console No. 
155 Get Date/Time 

160 Set List 

161 Cond. Attach List 


1-5 



TurboDOS 1.4 Z80 
Programmer's Guide 


FUNDAMENTALS 


Program Interface 
(Continued) 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


T-Functions To invoke a T-function, a program executes a 

CALL to location 0050H in the Base Page with 
a function number in the C-register. A dif¬ 
ferent entrypoint address is used to avoid 
conflict with C-function number assignments. 
TurboDOS supports the following T-functions: 

0 Reset O/S 22 Phys Disk Access 

1 Create Process 23 Set Buffer Parms 

2 Delay Process 24 Get Buffer Parms 

3 Allocate Memory 25 Lock/Unlock Drive 

4 Deallocate Memory 26 Flush/Free Buffers 

5 Send Message 27 Get/Set Print Mode 

6 Receive Message 28 Sig End-of-Print 

7 Set Error Address 29 Get/Set Despl Mode 

8 Set Abort Address 30 Queue a Print File 

9 Set Date/Time 31 Flush List Buffer 

10 Get Date/Time 32 Network List Out 

11 Rebuild Disk Map 33 Remote Console I/O 

12 Get TurboDOS S/N 34 Get Comm Status 

13 Set Compat. Flags 35 Comm Input 

14 Log-On/Log-Off 36 Comm Output 

15 Load File 37 Set Comm Baud Rate 

16 Activate Do-File 38 Get Comm Baud Rate 

17 Autoload On/Off 39 Set Modem Controls 

18 Send Command Line 40 Get Modem Status 

19 Get Alloc Info 41 User-Defined Funct'n 

20 Get Phys Disk Info 42 Reorg Disk Directory 

21 Get/Set Drv Status 43 Select Memory Bank 


Termination A program may terminate by jumping to loca¬ 

tion 0000H in the Base Page, or by invoking 
C-function 0 (System Reset). Both methods 
are entirely equivalent, and cause TurboDOS 
to terminate the program in TPA and prompt 
for the next command. A program may also 
terminate by invoking C-function 47 (Chain to 
Program), which allows the program to specify 
the next command to be executed after the 
program terminates. 
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BIOS Branch Table For compatibility with CP/M, TurboDOS pro¬ 
vides a full simulated "BIOS Branch Table" to 
support applications that make direct BIOS 
calls. The branch table is compatible with 

n n /m o o j .■ j- ~ __ i • _ _ 

. £. , auu xl. ax ways uey mb on a page 
boundary (multiple of 0100H) as in CP/M. 


.Offset. ,1_ Function 


base+0 

base+3 

base+6 

base+9 

base+12 

base+15 

base+18 

base+21 

base+24 

base+27 

base+30 

base+33 

base+36 

base+39 

base+42 

base+45 

base+48 


cold start 
warm start 

console status to A-reg 

console input to A-reg 

console output from C-reg 

printer output from C-reg 

raw console output from C-reg 

raw console input to A-reg 

home drive to track zero 

select drive from C-reg 

set track from BC-reg 

set sector from BC-reg 

set DMA address from BC-reg 

read disk sector 

write disk sector 

list status to A-reg 

sector translate from BC to HL 


Base Page location 0000H contains a JMP in¬ 
struction to the second (warm start) entry- 
point of the branch table. Thus, a program 
can always determine the base address of the 
branch table by obtaining the address found 
at Base Page location 0001H and subtracting 3 
from it. 
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Command 

Processing 

A TurboDOS command always identifies a pro¬ 
gram file residing on disk, and causes that 
program to be loaded into memory (TPA) and 
executed. TurboDOS has no "built-in" com¬ 
mands. 



TurboDOS comes with more than 30 standard 
command programs (described in detail in the 
User's Guide). You can expand the vocabulary 
of commands simply by storing additional 
programs on disk. Programs are usually kept 
in .COM files. 

Command 

Prompt 

TurboDOS displays a command prompt on the 
console whenever it is ready to accept a 
command. The command prompt is composed of 
the current user number, the current drive 
letter, and the } prompt symbol. 

Command 

Format 

Each TurboDOS command consists of the file 


name of the program to be executed, possibly 
followed by an optional command tail of up to 
126 characters. A command may be entered in 
upper- or lower-case letters, but is conver¬ 
ted to upper-case by TurboDOS. 

The program name may have an explicit file 
type, but usually doesn't (TurboDOS assumes 
.COM). It may also have a user/drive prefix 
(like "10:", "B:", or "5C:") to indicate that 
the program is under a particular user number 
or on a particular drive. You will get an 
error message if the program file cannot be 
found on disk, or if the available TPA is not 
big enough to hold the program. 

A special kind of command is used to change 
the current user number and/or drive. It 
consists of a user/drive prefix (like "10:", 
"B:", or "5C:") with no program name. 
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Tail Parsing The format of a command tail is determined by 

the particular program involved. TurboDOS 
passes the command tail to the program by 
saving the length of the tail (in characters) 
at location 0080H of the Base Page, and sav¬ 
ing the text of the tail (up to 126 charac¬ 
ters) starting at location 0081H. TurboDOS 
also stores a null (zero byte) immediately 
following the last character of the command 
tail. The tail includes all characters fol¬ 
lowing the program name, including leading 
spaces. If no tail is given in the command, 
the length stored at OO80H is zero. 

If the command tail consists of one or two 
filenames of the form: 

(uud:}filename{.typ} 

then TurboDOS parses each into File Control 
Block (FCB) format. The first parsed FCB is 
saved at location 005CH of the Base Page, and 
the second parsed FCB is saved at location 
006CH. Parsing is done following the proce¬ 
dure described for C-function 152 (Parse 
Filename). 


Command Strings TurboDOS also accepts strings of commands 

separated by the character \ (backslant). A 
command string may not exceed the size of the 
command buffer, which is normally big enough 
to accomodate two lines of text. 

TurboDOS executes each command of the command 
string in sequence. Normally, TurboDOS re¬ 
displays each command but the first as it is 
executed. However, the re-display is sup¬ 
pressed if the command string starts with a 
leading \ character. 
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Batch Processing TurboDOS supports a batch processing mode in 

which execution is controlled by a pre¬ 
defined sequence of commands stored in a "do- 
file" on disk. A do-file is a text file 
(usually type .DO), each line of which con¬ 
tains a valid TurboDOS command or command 
string. A do-file may be activated with a DO 
command, or by invoking T-function 16 (Acti¬ 
vate Do-File). A do-file may contain any 
number of embedded DO commands, and nesting 
is supported to any reasonable depth. 


Automatic Loading TurboDOS provides a facility for loading any 

program or executing any command sequence 
automatically at initial start-up (cold 
start) or whenever a program terminates (warm 
start). Autoload at cold-start takes place 
only if a file named COLDSTRT.AUT is present 
on the start-up disk. Autoload at warm-start 
takes place only if a file named WARMSTRT.AUT 
is present on the current disk. The AUTOLOAD 
command is the usual way to create these .AUT 
files. 

Alternatively, a program (.COM file) may be 
autoloaded by renaming it as COLDSTRT.AUT or 
WARMSTRT.AUT. In this case, however, the 
autoloaded program must not rely on the 
contents of the Base Page FCB (at 005CH) and 
buffer (at 0080H), because they will be left 
uninitialized by after the autoload. 
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Base Page Layout The Base Page is the 256-byte memory region 

from 0000H to 00FFH, and is used primarily 
for communication between TurboDOS and pro¬ 
grams running in the TPA. The organization 
of the Base Page is shown below: 



0000H-0002H Contains a JMP instruction 
to the warm-start entry- 
point in the BIOS branch 
table. A program usually 
terminates by executing a 
JMP 0000H. The address at 
location 0001H can be used 
to locate the BIOS branch 
table. 

0003H I/O byte, may be used to 

control device assignments 
in some implementations. 

0004H Least-significant 4 bits 

contains current drive. 
Most-significant 4 bits 
contains current user num¬ 
ber (modulo 15). 

0005H-0007H Contains a JMP instruction 
to the TurboDOS C-function 
entrypoint. A program may 
invoke a C-function by exe¬ 
cuting a CALL 0005H with a 
C-function number in the 
C-register. The address at 
location 0006H is highest 
useable address in the TPA 
plus one, and may be used 
by a program to find out 
how much memory it can use. 
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Base Page Layout 
(Continued) 


Locations 1 

Description _ 

0008H-003FH 

Reserved for interrupt vec¬ 
tors (RST 1 through 7). 

0040H-004FH 

(Unused, reserved) 

0050H-0052H 

Contains a JMP instruction 
to the TurboDOS T-function 
entrypoint. A program may 
invoke a T-function by exe¬ 
cuting a CALL 0050H with a 
T-function number in the 
C-register. 

00 53 H-005BH 

(Unused, reserved) 

005CH-006BH 

Default FCB part 1. The 
first filename argument in 
a command tail is parsed 
into this 16-byte area. 

006CH-007BH 

Default FCB part 2. The 
second filename argument in 
a command tail is parsed 
into this 16-byte area, and 
must be moved to another 
location before making use 
of the default FCB. 

007 CH 

Default FCB current record. 

007DH-007FH 

Default FCB random record. 

0080H-00FFH 

Default 128-byte buffer. 

This area receives the com¬ 
mand tail length in 0080H, 
and the command tail text 
(up to 126 characters plus 
a null terminator) in loca¬ 
tions 0081H-00FFH. 


1-12 





TurboDOS 1.4 Z80 FUNDAMENTALS 

Programmer's Guide 

System Start-Up 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


System Start-Up To get TurboDOS started, it is necessary to 

read a copy of the operating system from disk 
into memory, a process known as "cold start". 
The exact cold-start procedure depends on the 
particular hardware involved. 

Most TurboDOS implementations use this three- 
step cold-start procedure: 

1. When the computer is turned on or reset, 
it executes the TurboDOS bootstrap from 
read-only memory (ROM). (In some imple¬ 
mentations, the bootstrap may be loaded 
from reserved tracks on disk.) The 
bootstrap scans all disk drives from A 
to P, searching the directory of each 
ready drive for a file named OSLOAD.COM 
which contains the TurboDOS loader. 
When this file is found, the bootstrap 
loads it into the TPA and executes it. 

2. The TurboDOS loader scans all disk 
drives from A to P, searching for a file 
named OSMASTER.SYS which contains the 
master operating system. When this file 
is found, the loader proceeds to load 
the operating system into the upper 
portion of memory, then transfers con¬ 
trol to it. The drive from which the 
OSMASTER.SYS file was loaded becomes the 
"system disk". 

3. The master downloads a slave bootstrap 
routine into each slave processor. The 
master then locates a file named 
OSSLAVE.SYS on the system disk which 
contains the slave operating system, and 
downloads it into each slave processor. 

During network operation, it is helpful if 
the system disk is always on-line. If a 
fixed disk is available, it should be used as 
the system disk. 
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This section describes the TurboDOS file 
system in detail. It covers the structure of 
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FILE SYSTEM This section describes the TurboDOS file 

system in detail. It covers the structure of 
disks and files, the facilities provided to 
manage files, and the procedures for calling 
these facilities from application programs. 


Disk Capacity The TurboDOS file system can support up to 

sixteen logical drives per processor, identi¬ 
fied by the letters A through P. Drives may 
be local to the processor, or may be attached 
to another processor and accessed by means of 
networking. 

TurboDOS accomodates any combination of 
drives from mini-floppies to large hard disks 
in excess of a gigabyte. Allocation block 
size may be chosen individually for each 
drive, and affects maximum drive capacity as 
follows: 


1 Alloc. 

Block Size 

Max. Drive Capacity 1 


IK 

256 Kilobytes 1 


2K 

128 Megabytes ! 


4K 

256 Megabytes 1 


8 K 

512 Megabytes 1 


16 K 

1,024 Megabytes 1 


Because these limits are so big, it is almost 
never necessary to partition a physical drive 
into smaller logical drives under TurboDOS. 
However, such partitioning is sometimes done 
for user convenience when using large fixed 
disks. 

For maximum capacity and performance, floppy 
disks used with TurboDOS are generally for¬ 
matted with large sector sizes (512 or 1024 
bytes), no interleave, and no reserved 
tracks. However, TurboDOS also accomodates 
standard CP/M floppy disk formats. 
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Disk Organization Each disk is organized into five areas: 


File Storage 


Directory 

Allocation Map 
-VPlumfi Lab e l.. 
Reserved Tracks 


Reserved tracks are required by certain hard¬ 
ware configurations to support cold-start, 
but are not otherwise used by TurboDOS. The 
volume label permits a name to be given to 
each disk. The allocation map contains one 
bit for each allocation block on the disk, 
and is used by TurboDOS to keep track of 
which disk blocks are occupied and which are 
free. The directory is a table of contents 
which identifies all files stored on the 
disk. The remainder of the disk (most of it) 
is available for file storage. 

CP/M does not maintain a volume label or 
allocation map on the disks it creates. When 
a CP/M disk is first accessed by TurboDOS, 
the first few CP/M directory entries are 
automatically relocated to the end of the 
directory in order to make room for the label 
and map. When a TurboDOS disk is accessed by 
CP/M, the label and map appear to be ordinary 
deleted directory entries. Thus, disks can 
be moved freely between CP/M and TurboDOS 
in spite of the differences in organization. 
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Directory Formats TurboDOS supports two alternative directory 

formats: linear and hashed. A flag bit in 
the volume label indicates which format is in 
use on a particular disk. 

The standard linear format is compatible with 
CP/M, and is searched sequentially. Conse¬ 
quently, look-up speed deteriorates with 
increasing directory size, and can get pain¬ 
fully slow on large disks with many files. 

The optional hashed directory format uses a 
hashing algorithm to make look-up in large 
directories much faster. A hashed directory 
may be used on any disk, but is especially 
suited for use on hard disks with many files. 
Hashed directories are not media-compatible 
with CP/M, but may be converted to linear 
format whenever exporting to CP/M is needed. 

Whether the directory is linear or hashed, 
searches involving "wild cards" have to be 
done linearly. Such wild-card searches are 
typically slower if the directory is hashed. 


File Organization A file contains a sequence of 128-byte 

records, and may be up to 134 megabytes 
(1,048,576 records) long. The records of a 
file may be read and written sequentially or 
randomly (by relative record number). Up to 
128 records (16K) may be read or written in a 
single operation. A file may be extended by 
writing beyond the end of file. TurboDOS 
automatically allocates disk space when a 
file is extended, and deallocates it when a 
file is deleted. 

Text files are in ASCII with a RETURN (ODH) 
and LINEFEED (OAH) at the end of each line of 
text. Text lines are variable length and may 
span records. The end of a text file is 
marked by the character SUB (1AH). 
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File Operations About half of the C-functions supported by 

TurboDOS are connected with the file system. 
These functions support the operations needed 
to manipulate files, directories, and disks. 

The following functions provide the basic 
facilities for sequential file access: 


1 C-Fcn 1 

Function Name 


1 

1 15 

Open File 

1 

1 

1 16 

Close File 

1 

1 20 

Read Sequential 

1 

1 21 

Write Sequential 


1 22 

1 

Make File 

1 

1 

These additional functions are necessary 

to 

support random access and file sharing: 


1 C-Fcn 1 

Function Name 


1 

1 33 

Read Random 

1 

1 

1 34 

Write Random 

1 

1 35 

Compute File Size 

1 

1 36 

Set Random Record 

1 

1 42 

Lock Record 

1 

1 43 

1 

Unlock Record 

1 

Directory 

functions include: 


1. C-Fcn 1 

Function Name 


1 

1 17 

Search for First 

1 

1 

1 18 

Search for Next 

1 

1 19 

Delete File 

1 

1 23 

Rename File 

1 

1 30 

1 

Set File Attributes 

1 
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File Operations Drive-oriented functions are: 

(Continued) _ 

1 C-Fcn I _ Function Name 


1 

1 

1 A 

_L ** 

0^1 nLr 

OCICV^L L>101\ 

1 

1 

1 

24 

Return Login Vector 

1 

1 

25 

Return Current Disk 

1 

! 

28 

Write Protect Disk 

! 

1 

29 

Get R/0 Vector 

1 

1 

31 

Get DPB Address 

1 

1 

37 

Reset Drive 

1 

1 

1 

46 

Get Free Space 

1 

1 

Finally, 

some other functions connected 

with 

the 

file 

system include: 


1 

-Fen 

Function Name 

1 

1 

1 

13 

Reset Disk System 

1 

1 

1 

26 

Set DMA Address 

1 

1 

32 

Set/Get User Number 

1 

1 

44 

Set Multi-Sector Count 

1 

1 

47 

Chain to Program 

1 

1 

1 

152 

Parse Filename 

1 

1 


Each of these file system C-functions is 
described in detail later in this document. 
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TurboDOS keeps track of files by name, main¬ 
taining a directory of files on each disk. A 
file is identified uniquely by four fields: 

. user number (0-31) 

. drive letter (A-P) 

. file name (up to 8 characters) 

. file type (up to 3 characters) 

The user number specifies one of 32 logical 
file libraries on each disk. These libraries 
allow files to be conveniently segregated by 
user or application. Generally, user 0 is 
reserved for global files and user 31 is 
reserved for log-on security, leaving 1-30 
for general use. If no user number is given, 
the current user number is assumed by 
default. 

The drive letter specifies the disk on which 
the file is located. If no drive letter is 
given, the current drive is assumed by 
default. 

The name and type fields are composed of 
ASCII characters. The file name may have up 
to eight characters, and the file type may 
have up to three. Shorter names and types 
are padded on the right with spaces. 

It is suggested that file names and file 
types be composed from the upper-case letters 
A-Z and the digits 0-9. Actually, any ASCII 
characters may be used including lower-case 
letters, punctuation, and even non-printing 
control characters. However, such names may 
not be parsed correctly in commands nor dis¬ 
played correctly in directories. 

The question mark ? is a special wild-card 
character which may be used in file names and 
types to match any character in the corre¬ 
sponding position during directory searches. 
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Special File Names 


TurboDOS gives special meaning to two 
reserved file names. '^.DIR” refers to the 
directory area of a disk, while "$.DSK" 
refers to the entire contents of the physical 
disk volume (up to the maximum file size of 
134 megabytes). These special files may be 
dumped, patched, or accessed like any ordin¬ 
ary file. However, access is restricted to 
privileged log-ons only. 


File Control Block File-oriented C-functions and T-functions are 

always called with the address of a File 
Control Block (FCB) in the DE-register. The 
FCB is a data structure 33 bytes long (36 
bytes for random access operations) organized 
as follows: 


Offset I Field 1 _ Description 

0 drive drive code (0-16) : 

0 -> current drive 

1 -> drive A 

2 -> drive B 

4 • 

16 -> drive P 


1-8 name file name in ASCII, 

padded on right with 
spaces, high-order bit 
of each byte reserved 
for attributes fl-f8 


9-11 


12 


type file type in ASCII, 

padded on right with 
spaces, high-order bit 
of each byte reserved 
for attributes tl-t3 

extent least significant five 

bits of extent number 
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Block 


Offset 

1 Field 

1 Description 

13 

sped 

flag byte (Do Not Use) 

14 

spec2 

most significant eight 
bits of extent number 

15 

record 

count 

number of records in 
current extent (0-128) 

16-31 

map 

allocation map of cur¬ 
rent extent 

32 

current 

record 

current record number 
(0-127) in current ex¬ 
tent 

33-35 

random 

record 

20-bit record number 
(byte 33 is least sig¬ 
nificant) for random- 
access operations 


In general, the application program must 
initialize FCB bytes 0-12 before opening, 
making, or searching for a file. It must 
also zero FCB byte 32 before reading or writ¬ 
ing a file sequentially from the beginning. 

When a file is opened, TurboDOS fills FCB 
bytes 0-31 with information from the direc¬ 
tory. Thereafter, the application program 
should not modify FCB bytes 0-31. When the 
file is closed, TurboDOS updates the direc¬ 
tory with information from the FCB. A direc¬ 
tory entry has the same structure as the 
first 32 bytes of an FCB. In a directory 
entry, however, byte 0 contains the user 
number 0-31 to which the file belongs, or the 
value 0E5H if the directory entry is not in 
use. Also, byte 13 may contain the exact 
byte count of the last record in the file. 
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File Attributes File attributes are stored in the high-order 

bits of the FCB name field bytes fl-f8 and 
type field bytes tl-t3, and are used to con¬ 
trol how a file may be accessed: 


A tt rib ut e 1 _ Definition _ 

fl FIFO file attribute 

f2-f4 undefined file attributes 

f5-f8 interface attributes 

tl read-only file attribute 

t2 global file attribute 

t3 archived attribute 


The file attribute bits fl-f4 and tl-t3 are 
recorded in the directory, and may be set or 
cleared by means of C-function 30 (Set File 
Attributes). For a newly-created file, all 
attribute bits are initialized to zero. When 
a file is opened, its attributes are copied 
into the FCB. File attributes may also be 
interrogated by means of C-functions 17 and 
18 (Search for First/Next). 

The read-only attribute (tl) prevents a file 
from being written, deleted or renamed. The 
global attribute (12) enables a file saved 
under user 0 to be accessed from any user 
number (it has no effect for files saved 
under non-zero user numbers). The archived 
attribute (t3) is used for incremental file 
backup, and is automatically cleared by 
TurboDOS whenever a file is written or 
renamed. The FIFO attribute (fl) causes a 
file to be accessed using a special "first-in 
first-out" access method (described later). 

Attributes f2-f4 are undefined, and available 
to the user. Interface attribute bits f5-f8 
cannot be used as file attributes? they 
specify options for certain C-functions. 
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User Numbers TurboDOS provides 32 file libraries on each 

disk corresponding to user numbers 0-31. 
Generally, user 0 is reserved for global 
files and user 31 is reserved for log-on 
security, leaving 1-30 for general use. 

The current user number is established ini¬ 
tially at log-on. For a non-privileged log¬ 
on, the user number remains unchanged until 
log-off. This restricts file access to the 
corresponding file library (plus global files 
under user 0). For a privileged log-on, the 
user number may be changed without restric¬ 
tion by means of C-function 32 (Set/Get User 
Number). 

The current user number is treated as a pre¬ 
fix to file names, thereby allowing each disk 
directory to contain up to 32 libraries. 
Most directory functions (make, rename, 
delete, search, etc.) are restricted to the 
library corresponding to the current user 
number. However, files in the user 0 library 
which have the global file attribute may be 
opened from any user number. This permits 
commands, programs, and other common files to 
be shared by all users. 


File Sharing In a multi-user TurboDOS system, it is pos¬ 

sible for multiple users to access the same 
file at the same time. This can happen if 
the users are logged-on to the same user 
number, or accessing the same global file. 
TurboDOS supports interlocks to regulate such 
file sharing at the file or record level. 

TurboDOS file sharing facilities are compa¬ 
tible with MP/M, but provide significant 
extensions to alleviate the most serious 
deficiencies in MP/M file sharing. 
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File Locks 


File-level interlocks are supported by means 
of four distinct modes of opening a file. 
The open mode is determined by FCB interface 
attributes f5-f6 when the file is opened or 

J m l~ « P 11 V> >-V VN /N n V 1 T 

ticaicu# .Lilt: J- u u i. u^cu iiiuuco cllk : cancu 

exclusive, shared, read-only, and permissive. 


A file opened in exclusive mode is available 
to the opening process exclusively until it 
is closed, and may not be opened by any other 
process. A file cannot be opened in exclu¬ 
sive mode if the file is currently opened (in 
any mode) by another process. 

A file may be opened in shared mode by any 
number of processes simultaneously. All 
processes are allowed to read, write and 
extend the file. Record lock and unlock 
functions are honored only for file opened in 
shared mode. 


A file may be opened in read-only mode by any 
number of processes simultaneously. All 
processes are allowed to read the file, but 
not to write or extend it. 

A file may be opened in per m issive mode by 
any number of processes simultaneously. All 
processes are allowed to read the file. If 
any process writes or extends the file, then 
that process gains an exclusive write-lock on 
the file, preventing any other process from 
writing to the file. The exclusive write- 
lock is released when the locking process 
closes the file. 

In shared and permissive modes, if a process 
extends a file by adding new records at the 
end, these records become immediately acces¬ 
sible to other processes that also have the 
file open. 
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Record Locks Record-level interlocks are controlled by 

means of explicit locking and unlocking 
requests made by the application program. 
This allows concurrent update by multiple 
processes. 

Record locks are by no means automatic, and 
require explicit cooperative participation by 
all updating programs. C-functions 42 (Lock 
Record) and 43 (Unlock Record) are honored 
only for files opened in the shared mode. 
Each program must lock a record before read¬ 
ing it, and must unlock the record after 
updating it. 

If a program attempts to lock a record that 
is already locked by another process, the 
Lock Record function returns an error code 
and the program must try again until it is 
successful. Alternatively, the program can 
ask TurboDOS to suspend program execution 
automatically until the lock request can be 
satisfied. 

To extend a shared file in a concurrent 
update environment, the extending program 
should first acquire a lock on record N+l 
(where N is the last record in the file). 
The program may then safely write record N+l, 
and finally unlock N+l. 
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Compatibility Modes The file sharing facilities of TurboDOS are 

designed to provide compatibility with MP/M, 
yet at the same time to alleviate the most 
serious limitations of MP/M file sharing. 
TurboDOS may be instructed to adhere strictly 
to MP/M file-sharing rules, or alternatively 
to relax some of these rules. To this end, 
TurboDOS provides a byte of "compatibility 
flags" with the following bit assignments: 


Bit I Flag Name I 

7 permissive 

6 suspend 

5 global-write 
4 mixed-mode 

3 logical 

2-0 (not defined) 


_AflLgcts_ 

defau.lt open mode 
lock conflict action 
writing global files 
mixed file open modes 
record lock validity 


For each compatibility flag, a zero-bit de¬ 
notes strict adherence to the MP/M rule, 
while a one-bit signifies a relaxation of 
that rule. The initial setting of the com¬ 
patibility flags may be established during 
TurboDOS system generation by assigning the 
desired value to the symbolic location 
COMPAT. A program may modify its compati¬ 
bility flags by calling T-function 13 (Set 
Compatibility Flags), but the flags automati¬ 
cally revert to their initial setting when 
the program terminates. 

If the per missive flag (bit 7) is set, the 
default file open mode is permissive, rather 
than exclusive (as in MP/M). Specifically, 
the open mode is determined when a file is 
opened or created by FCB interface attributes 
f5-f6, as shown in the following table: 
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Compatibility Modes 
(Continued) 


permissive flag = 0 permissive flag. = 1 


f 6 

f5 

open mode 

1 f 6 

f 5 

open mode 

0 

0 

exclusive 

1 

I 0 

0 

permissive 

0 

1 

shared 

1 0 

1 

shared 

1 

0 

read-only 

1 1 

0 

read-only 

1 

1 

read-only 

1 1 

1 

1 

exclusive 


If the suspend flag (bit 6) is set, then an 
attempt to lock a record that is already 
locked by someone else causes the process to 

be.suspended until its lock request can be 

satisfied. Otherwise, an attempt to lock or 
write to a record that is already locked by 
someone else results in an immediate error 
return code (as in MP/M). 

If the .global - WlitS flag (bit 5) is set, then 
a program running under a non-zero user 
number may both read and write global files. 
Otherwise, access to global files is strictly 
read-only (as in MP/M). 

If the m ixed -m ode flag (bit 4) is set, then 
one process may open a file in shared mode 
while another has it open in read-only mode 
(or vice-versa). Otherwise, the shared and 
read-only modes are mutually exclusive (as in 
MP/M) . 

If the l ogic al flag (bit 3) is set, then the 
FCB random record field for C-functions 42 
and 43 (Lock/Unlock Record) is interpreted 
as an arbitrary 24-bit logical record number 
which is not validated and does not cause 
file positioning. Otherwise, the FCB random 
record field for C-functions 42 and 43 is 
interpreted as the relative number of a 128- 
byte record, and causes the file to be posi¬ 
tioned to that record (as in MP/M). 
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FIFO Files 


To facilitate communications between proces¬ 
ses, processors and users, TurboDOS supports 
a special kind of file called a FIFO (first- 
in, first-out) similar in concept to a Unix 

v a » rl a 1 a r* /-\ rJ v* a rl o r» rl 
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written exactly like ordinary sequential 
files. However, a record written to a FIFO 
is always appended to the end, and a record 
read from a FIFO is always taken from the 
beginning and removed from the FIFO. 


A FIFO is differentiated from other files by 
the presence of the FIFO attribute (fl) in 
the directory. Record zero of a FIFO is a 
header record used by TurboDOS to keep track 
of the FIFO, and is organized as follows: 


Offset i _ Contents _ 

0 type (0=RAM, -l=disk) 

1 mode (0=error code, -l=suspend) 

2-3 maximum size (records) 

4-5 current size (records) 

6-7 number of last record read 
8-9 number of last record written 

10-127 (not used, reserved) 


The header specifies whether the body of the 
FIFO is RAM- or disk-resident, and the maxi¬ 
mum number of records it may contain. RAM- 
resident FIFOs provide high-speed but limited 
capacity (up to 127 records, usually much 
less). Disk-resident FIFOs provide large 
capacity (up to 65,535 records) but slower 
speed. The FIFO command may be used to 
create a FIFO and initialize its header. 
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FIFO Files Normally, reading from an empty FIFO returns 
(Continued) an end-of-file code (A=l), and writing to a 

full FIFO returns a disk-full code (A=2). 
However, if the mode byte in the FIFO header 
is set to -1 (suspend), then reading from an 
empty FIFO or writing to a full FIFO causes 
the process to be suspended until the FIFO 
becomes non-empty or non-full. 

The header or disk-resident body of a FIFO 
may be accessed directly using C-functions 33 
and 34 (Read/Write Random), thereby bypassing 
the normal first-in first-out protocol. An 
attempt to make (C-function 22) an existing 
FIFO is treated as an open (C-function 15), 
while an attempt to delete (C-function 19) a 
FIFO is ignored. The only way to get rid of 
a FIFO is first to clear the FIFO attribute, 
then delete it. 


Queue Emulation In order to support MP/M applications that 

depend on queues, TurboDOS emulates the MP/M 
queue facility by using RAM FIFOs. These 
queue-related C-functions are supported: 


C-Fcn 1 _ Function Name 

134 Make Queue 

135 Open Queue 

136 Delete Queue 

137 Read Queue 

138 Conditional Read Queue 

139 Write Queue 

140 Conditional Write Queue 


C-function 134 (Make Queue) creates a RAM 
FIFO with the specified queue name (mapped to 
upper case) and type ".QUE", while the other 
queue-related C-functions operate on such 
FIFOs. (See the description of C-function 
134 for details and limitations.) 
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Buffer Management 


The TurboDOS buffer manager performs multi¬ 
level buffering of physical disk input/out¬ 
put, using least-recently-used (LRU) buffer 
assignment and other sophisticated optimiza- 


Dn-P-Pr\ v *» irsrt 
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provides s 
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tion in the number of physical disk accesses 


during both sequential and random file opera¬ 
tions . 


The number and/or size of disk buffers may be 
changed by means of T-function 23 (Set Buffer 
Parameters), and interrogated by T-function 
24 (Get Buffer Parameters). The number of 
buffers must be at least two, and the buffer 
size must be at least as large as the physi¬ 
cal sector size of the disks being used. For 
optimum performance, the number of buffers 
should be as large as possible consistent 
with the TPA size required. 

The buffer manager maintains its buffers on 
two lists: the "in-use" list and the "free" 
list. Whenever the file manager requests a 
disk access, the buffer manager first checks 
the in-use list to see if the requested disk 
sector is already in a buffer. Most of the 
time it is, and no physical disk access is 
required. If not, the buffer manager at¬ 
tempts to acquire a new buffer from the free 
list. If the free list is empty, the least- 
recently-used buffer (at the end of the in- 
use list) is written out to disk if neces¬ 
sary, and then reused to receive the newly 
requested disk sector. 
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Media Changes Before a removable disk volume is changed, it 

is crucial that any buffers relating to that 
disk are written out if necessary, and re¬ 
turned to the free list. In single-user 
configurations of TurboDOS, this is done 
automatically whenever the system pauses for 
console input. In multi-user configurations, 
buffers must be explicitly flushed and freed 
by calling T-function 26 (Flush/Free Buffers) 
prior to changing disks. This is most com¬ 
monly done by executing the CHANGE command, 
but should also be coded into applications 
that require media changes during operation. 
For safety, TurboDOS also flushes buffers 
automatically during any lull in system acti¬ 
vity, and frees them automatically whenever a 
disk drive becomes not-ready. 


Load Optimization TurboDOS contains a program load optimizer 

which greatly improves the speed of program 
loading and overlay fetching from local disk 
drives. This module scans the allocation map 
of program files to be loaded into TPA, de¬ 
tects sequentially-allocated file segments 
(often 16K or more), and loads these segments 
at the maximum transfer rate of the disk 
controller. This provides a manyfold in¬ 
crease over normal sequential file access 
performed one 128-byte record at a time. 

The program load optimizer is utilized auto¬ 
matically by the command line interpreter and 
the autoload processor, and is also acces¬ 
sible to user programs by means of T-function 
15 (Load File). 

TurboDOS cannot use the optimizer to load 
from a remote drive over the network, nor to 
load into a banked TPA (in both cases the TPA 
is not accessible to the disk controller). 
Instead, TurboDOS uses its multi-sector read 
capability to optimize program loading. 
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Error Handling In the event of an unrecoverable disk error, 

TurboDOS normally displays a diagnostic mes¬ 
sage in one of these formats: 


j i 
I Read Error, Drive A, Track 0, Sector 2 I 
I [Retry, Ignore, Abort] I 

I Write Error, Drive B, Track 5, Sector 16 I 
! [Retry, Ignore, Abort] I 
i i 
I Not Ready Error, Drive C [Retry, Abort] I 

I Spooler Error [Ignore, Abort] I 


and waits for the user to choose the desired 
recovery option by keying in the appropriate 
letter (R, I or A). 

An application program may elect to intercept 
and process such errors, however, by calling 
T-function 7 (Set Error Address). In this 
case, TurboDOS does not display its usual 
diagnostic messages. Normal error processing 
resumes automatically when the application 
program terminates. 

NOTE: Because the buffer manager optimizes 
disk write operations by deferring them as 
long as possible, write errors may be repor¬ 
ted later than expected and possibly even to 
a different user than expected. 
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(Intentionally left blank.) 
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SERIAL I/O 

This section describes the TurboDOS facili¬ 
ties that deal with serial input/output (I/O) 
in connection with consoles, printers, and 
communications channels. 

Console I/O 

TurboDOS provides ten C-functions that permit 
programs to interact with the user console 
device. Three kinds of console input/output 
are supported in TurboDOS: basic I/O, raw 
I/O, and string I/O. 


Basic Console I/O Three C-functions provide basic console I/O 

on a single-character basis: 


1 C-Fcn 

Function Name 


1 1 

Console Input 


1 2 

Console Output 


1 11 

Get Console Status 



The Console Input function waits for a char¬ 
acter to be keyed in# echoes the character to 
the console screen to provide visual confir¬ 
mation, and returns the character to the 
calling program. 

The Console Output function displays a char¬ 
acter on the console screen. It expands hori¬ 
zontal tab characters into spaces, based upon 
tab stops at every eighth column. 

The Get Console Status function checks to see 
whether or not a console input character is 
available, and returns a Boolean result. 
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Raw Console I/O Three additional C-functions provide raw 

console I/O: 


1 C-Fcn 

1 Function Name 


1 3 

Raw Console Input 


1 4 

Raw Console Output 


1 6 

Direct Console I/O 



The Raw Console Input function is similar to 
the basic Console Input function, except that 
input characters are not echoed to the 
screen. Likewise, the Raw Console Output 
function is like the basic Console Output 
function, except that horizontal tabs are not 
expanded. 

The Direct Console I/O function combines the 
functions of Raw Console Input, Raw Console 
Output, and Console Status. It is supported 
only for compatibility with CP/M. 


String Console I/O The remaining console I/O functions provide 

input and output of character strings: 


1 C-Fcn 

Function. Name_ 


1 9 

Print String 


1 10 

Read Console Buffer 


1 110 

Get/Set Delimiter 


1 111 

Print Block 



The Print String function outputs a string of 
characters to the console. The string may be 
of any length, and is terminated by a re¬ 
served delimiter. The delimiter is normally 
the dollar-sign $ character, but may be 
changed by means of the Get/Set Delimiter 
function. 
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String Console I/O The Print Block function is similar to Print 
(Continued) String, except that the string length is 

passed explicitly so that no delimiter is 
needed. Both Print String and Print Block 
expand horizontal tabs. 

The Read Console Buffer function reads an 
entire line of edited input from the console. 
Characters are accepted from the console and 
stored in successive memory locations until a 
carriage-return terminates the line. Input 
characters are echoed to console output (but, 
unlike CP/M, tabs are not expanded). Rudi¬ 
mentary editing is supported: backspace or 
delete characters erase the last typed char¬ 
acter, while CTRL-U or CTRL-X erase the 
entire line. 


Console Certain multi-user application programs need 

Identification to identify uniquely the console to which 

they are attached. TurboDOS supports this 
requirement with two C-functions: 


C-Fcn 

! Function Name 

12 

Return Version 

153 

Get Console Number 


C-function 153 (Get Console Number) is compa¬ 
tible with MP/M, and returns an 8-bit console 
number. Under TurboDOS, this console number 
is only guaranteed to be unique in simple 
(one circuit) networks. 

C-function 12 (Return Version) returns a 16- 
bit network address that is unique even in 
complex TurboDOS networks. 
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Attention Requests The execution of a program or do-file may be 

suspended at any time by typing a reserved 
"attention" character on the console key¬ 
board. In most installations, this is either 
CTRL-S or BREAK. TurboDOS will "beep" to 
acknowledge that it has received the atten¬ 
tion request. 

After an attention request, the interrupted 
program or do-file will remain suspended 
until one of the following attention respon¬ 
ses is typed: 

CTRL-Q (resume) simply restarts execution at 
the point of interruption. 

CTRL-C (abort) cancels execution of the in¬ 
terrupted program or do-file, causes any 
nested commands and do-files to be disregar¬ 
ded, and returns to the command prompt. An 
application program may elect to intercept 
such abort requests, however, by calling T- 
function 8 (Set Abort Address). 

CTRL-P (echo-print) restarts execution and 
causes all subsequent console output also to 
be echoed to the printer. A second atten¬ 
tion/echo sequence turns off echoing of con¬ 
sole output to the printer. 

CTRL-L (end-print) restarts execution after 
signalling the end of the current print job. 
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I/O In order to allow communications-oriented 
applications programs to be written in a 
hardware-independent fashion, TurboDOS sup¬ 
ports a standard communications channel in¬ 
terface consisting of seven T—functions? 


T-Fcn 1 _ Function Name _ 

34 Get Comm Channel Status 

35 Comm Channel Input 

36 Comm Channel Output 

37 Set Comm Channel Baud Rate 

38 Get Comm Channel Baud Rate 

39 Set Comm Channel Modem Controls 

40 Get Comm Channel Modem Status 


These functions support multiple channels of 
communications. T-functions 34-36 provide 
basic single-character comm channel I/O (ana¬ 
logous to raw console I/O). T-functions 37- 
38 allow programs to sense or set the comm 
channel baud rate to any standard speed from 
50 to 19,200 baud. T-functions 39-40 allow 
programs to set modem control signals (RTS, 
DTR) and to sense modem status signals (CTS, 
DSR, DCD, RI). 
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Printer Output TurboDOS provides the basic printing func¬ 

tions of CP/M, plus an elaborate concurrent 
printing facility which offers several modes 
of print spooling and flexible print routing 
among multiple printers and print queues. 
The spooling and routing facilities are com¬ 
pletely transparent to application programs. 


Basic Printing Two C-functions provide the basic means for 

programs to generate printer output: 


C-Fcn 

L._ 

Function Name 

5 

List 

Output 

112 

List 

Block 


The List Output function outputs a single 
character to be printed, while the List Block 
function outputs a character string of speci¬ 
fied length. In contrast to console I/O, 
these print output functions do not expand 
tabs. 
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Control Functions Four T-functions provide control over the 

print spooling, de-spooling, and queuing 
mechanisms of TurboDOS: 


m __ o — 

x — r (ju 

i 

i 

Function Name 

27 

Get/Set 

Print Mode 

28 

Signal 

End-of-Print 

29 

Get/Set 

De-Spool Mode 

30 

Queue a 

Print File 


The Get/Set Print Mode function controls 
print routing. Print output may be routed 
direct to a specified printer, spooled to a 
specified drive and print queue, displayed on 
the console, or simply discarded. 

The Signal End-of-Print function allows a 
program to terminate a print job explicitly. 
In the absence of this function, a print job 
ends automatically at the conclusion of the 
program, upon receipt of an end-print atten¬ 
tion request from the console, or when a 
reserved end-of-print character (if defined) 
appears in the print output stream. 

The Get/Set De-Spool Mode function controls 
background printing (de-spooling). A printer 
may be assigned to de-spool from a specified 
queue, or may be placed in an off-line 
status. Any print job in process may be 
stopped, resumed, restarted from the begin¬ 
ning, or terminated altogether. 

The Queue a Print File function permits a 
program to queue a print file (or any text 
file, for that matter) for background print¬ 
ing. The file may be placed on any specified 
print queue, and may be saved or deleted 
automatically after printing. 
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C—FUNCTIONS 


This section describes the CP/M-compatible 
functions ("C-functions") supported by Turbo¬ 
DOS. The C-functions are presented in numer¬ 
ical order, with calling parameters, return 


T7 a 1 no 
V U± 
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To invoke a C-function, a program executes a 
CALL to location 0005H in the Base Page with 
a function number in register C. Byte-length 
arguments are passed in register E, and word- 
length arguments in register DE. C-functions 
return byte-length values in register A (dup¬ 
licated in L), or word-length values in 
register HL (duplicated in BA). 


If a C-function call is made with register C 
set to an unsupported function number, Turbo¬ 
DOS returns immediately with registers HL and 
BA zeroed. 


C-function calls generally destroy registers 
A-B-C-D-E-H-L, but preserve X, Y, and the 
alternate register set. 
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C-Function 0 

Entry Arguments 


Explanation 


System Reset 


Rea 1 

Description_ 

o 

ii 

o 



The System Reset function terminates the 
calling program ("warm-start"). Program 
termination is more commonly performed by 
executing a jump to location 0000H, which has 
exactly the same effect. 

Program termination ends any active print 
job, and restores the current user number and 
current drive that were in effect when the 
program was originally loaded into TPA. In a 
multi-user TurboDOS system, program termina¬ 
tion closes any open files, and releases any 
locked records or devices. 
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C-Function 1 

Entry Arguments 


Returned Value 


Explanation 


Console Input 


Reg 1 

. Description 

r 

V - JL. 



Reg 1 

Description 

A = 

input character 


The Console Input function obtains the next 
character from the console keyboard, and 
returns it in register A. If no character is 
available, the calling program is suspended 
until a character is typed. 

Graphic characters and certain control char¬ 
acters (carriage-return, line-feed, and back¬ 
space) are echoed to the console screen. 
Horizontal tabs are expanded into multiple 
spaces, based upon tab stops at every eighth 
column. 
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C-Function 2 

Entry Arguments 


Explanation 


Console Output 

I Reg 1_ Description 

I 

I C = 2 

I E = output character 


The Console Output function 
character passed in register E 
screen. Horizontal tabs are 
multiple spaces, based upon 
every eighth column. 


displays the 
on the console 
expanded into 
tab stops at 


STr 'p 7 
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C-Function 3 

Entry Arguments 




Explanation The Raw Console Input function obtains the 

next character from the console keyboard, and 
returns it in register A. If no character is 
available, the calling program is suspended 
until a character is typed. Input characters 
are not echoed to the console screen. 

This function is compatible with MP/M. (In 
CP/M 2.2, this function is Input from Reader 
Device. In CP/M 3, this function is Auxil¬ 
iary Input.) 
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C-Function 4 

Entry Arguments 


Explanation 


Raw Console Output 


Reg I_ Description 

C = 4 

E = output character 


The Raw Console Output function displays the 
character passed in register E on the console 
screen. Horizontal tabs are not expanded. 

This function is compatible with MP/M. (In 
CP/M 2.2, this function is Output to Punch 
Device. In CP/M 3, this function is Auxil¬ 
iary Output.) 

nr ? 
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C-Function 5 

Entry Arguments 

Explanation 


List Output 



I n — c i 

i — j i 

I E = output character I 


The List Output function sends the character 
passed in register E to be printed according 
to the current print routing. Horizontal 
tabs are not expanded. 
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C-Function 6 

Direct 

Console I/O 

Entry Arguments 

1 Reg 1 

Description 

1 

1 C = 
1 E = 
1 

1 

1 

1 

6 

-1 (for combined status/input) 

-2 (for status) 

-3 (for raw input) 

output character (for raw output) 




Returned Value 

1 Reg 1 

Description 


1 

1 A = 
1 

input character or status 


Explanation The Direct Console I/O function performs one 

of four possible sub-functions, depending 
upon the argument passed in register E. 

If E = -1 (OFFH) , then any available console 
input character is returned in register A, 
without echo to the screen. If no character 
is available, the function returns A = 0. 

If E = -2 (OFEH), then this function returns 
console status (A = 0 if no console input is 
available, or A = -1 otherwise). Equivalent 
to C-function 11 (Get Console Status). 

If E = -3 (OFDH) , then this function obtains 
the next console input character and returns 
it in register A, without echo to the screen. 
If no character is available, the calling 
program is suspended until a character is 
typed. Equivalent to C-function 3 (Raw Con¬ 
sole Input). 

For other values of E, this function displays 
the character on the console screen. Hori¬ 
zontal tabs are not expanded. Equivalent to 
C-function 4 (Raw Console Output). 
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C-Function 7 

Get I/O Byte 


Entry Arguments 

1 Rea 1 

Description 


1 

i c = 7 

1 





Returned Value 

1 Rea 1 

Description 


1 

1 A = contents 

1 

of I/O byte (loc 0003H) 


Explanation This function simply returns the value of 

Base Page location 0003H (which is used in 
some implementations to control serial I/O 
device assignment). 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-Function 8 

Entry Arguments 


Explanation 


Set I/O Byte 

I Reg I _ Description- 

I 

I C = 7 

I E = new value of I/O byte (loc 0003H) 


This function simply sets the value of Base 
Page location 0003H (which is used in some 
implementations to control serial I/O device 
assignment). 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-Function 9 

Entry Arguments 


Explanation 


Print String 


Reg 1 

Description 

C =9 

DE = string 

address 


The Print String function displays a string 
of characters on the console screen. The 
string may be of any length, and is termina¬ 
ted by a reserved delimiter. The delimiter 
is normally the dollar-sign $ character, but 
may be changed by means of C-function 110 
(Get/Set Output Delimiter). Horizontal tabs 
are expanded into multiple spaces, based upon 
tab stops at every eighth column. 
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C-Function 10 

Entry Arguments 


Explanation 


Read Console Buffer 


Reg 1 _Description. 

C = 10 

DE = buffer address 


The Read Console Buffer function reads an 
entire line of edited input from the console. 
The input buffer whose address is passed in 
register DE has the following structure: 


Offset 1 

Direction 1 

1 Description__ 

0 

passed 

max input size (N) 

1 

returned 

actual input (0-N) 

2 to N+l 

returned 

input characters 


The first byte of the buffer must be preset 
to the maximum number of characters allowed 
in the input line. 

Console input is accepted until terminated by 
a carriage-return. Input errors may be cor¬ 
rected by typing BACKSPACE or DELETE to erase 
one character at a time, or CTRL-U or CTRL-X 
to erase the entire line. Characters in 
excess of the maximum are not accepted, and 
diagnosed with a "beep". Input characters 
are echoed to the console screen. Unlike 
CP/M, this function does not expand tabs in 
TurboDOS. 

Upon return, the second byte of the buffer 
contains the actual number of input charac¬ 
ters in the buffer. The input line is 
returned starting at the third byte of the 
buffer. The terminating carriage-return is 
neither stored in the buffer nor included in 
the count. Unused buffer positions following 
the last input character are uninitialized. 
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C-Function 11 
Get Console Status 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 11 

Entry Arguments 


Get Console Status 


.Rag- 


Description 


= ii 


Returned Value 


Explanation 


I Reg I 


Description 


_I 

I I 
I A = -1 if console input is available i 
I 0 if console input is not available I 
I_I 

The Get Console Status function checks to see 
whether or not a console input character is 
available. If console input is available, it 
returns A = -1. Otherwise, it returns A = 0. 


TurboDOS 1.4 Z80 C-FUNCTIONS 
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C-Function 12 
Return Version 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 12 

Entry Arguments 


Returned Values 


Explanation 


Return Version 


Reg 

1 

Description 

C 

= 12 



Reg 

1 

Description 

H 

L 

DE 

= 00H (meaning: CP/M, not MP/M) 

= 31H (meaning: BDOS version 3.1) 

= network address 


The Return Version function provides informa¬ 
tion on the latest compatible version of 
CP/M. (The BDOS version number returned in 
register L may be changed by patching the 
symbol CPMVER during system generation.) 

This function also returns a network address 
in register DE. This address is obtained 
from the first entry of the circuit assign¬ 
ment table (CRTAST). It may be used wherever 
a unique processor or console identification 
is required. 


QL b 'JZ.1 


•)/!% 
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C-Function 13 
Reset Disk System 


Copyright 1984 by Software 2000, inc. 
All rights reserved. 


C-Function 13 

Entry Arguments 


Reset Disk System 


Reg 1 

Description 

n — i q 

^ — JL 



In TurboDOS, the only effect of the Reset 
Disk System function is to reset the current 
DMA address to 0080H. (See C-function 26, 
Set DMA Address.) 


Explanation 


TurboDOS 1.4 Z80 
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C-Function 14 
Select Disk 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-*Function 14 

Entry Arguments 


Explanation 


Select Disk 


Reg I_ Description. 

C = 14 

E = selected disk drive: 

0 for drive A 

1 for drive B 

15 for drive P 


The Select Disk function causes the disk 
drive specified in register E to be selected 
as the current (default) disk drive. The 
current drive is used in subsequent file 
operations whenever the FCB drive field is 
set to zero. 

-fo \(Z‘ *•' V/ 1 / 

■'* r - • - ; , '■ r f' '■ " h 
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C-Function 15 
Open File 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 15 Open File 


Entry Arguments 


I - ite . 9 I -D-e-Scjip.ti. on _I 

I ! 

i C = 15 j 

I DE = FCB address I 


Returned Value 


Explanation 


. . 1 . 


Descrip tion_ 


I A = 0 if successful 
I -1 if file not found 


I 


The Open File function opens the file speci¬ 
fied by the FCB drive, name, type, and extent 
fields (bytes 0 through 12). Normally, the 
extent field (byte 12) should be set to zero. 
The specified file must exist under the cur¬ 
rent user number or must be a global file 
under user 0. 


The open mode is determined by compatibility 

■p 1 o n K i 4- H ( r\v rn ■* c O ^ Tt 'n ^ v\ Ur* i. U nPp J M L. ^ w. 

u / \jc/ciilu.bDivc/ anu uy ulic: r iiatL” 

face attributes f5 and f6, as shown in the 
following table: 


P£jRissjy^flag_E_.OL., germissive f lag = 1 



f 5 

1 open mode 

1 

1 f6_ 

£5 

1 open mode 


1 0 

0 

exclusive 

1 

1 

1 

1 0 

0 

permissive 


1 0 

1 

shared 

1 

1 0 

1 

shared 


1 1 

0 

read-only 

1 

1 1 

0 

read-only 


1 1 

1 

read-only 

1 

1 

1 1 

I 

1 

exclusive 



If the FCB current record field (byte 32) is 
set to -1, this function returns the byte 
count of the last record of the file in the 
current record field. The calling program 
should zero the current record field before 
doing sequential reads or writes. 
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C-Function 16 
Close File 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 16 

Entry Arguments 


Returned Value 


Explanation 


Close File 


Rea 1 

Description 


C = 
DE = 

16 

FCB address 



Req 1 

Description 


A = 

0 if successful 
-1 if file not found 



The Close File function closes a file pre¬ 
viously opened by an Open File (15) or Make 
File (22) C-function. The directory is up¬ 
dated if necessary to reflect any new blocks 
allocated to the file, and any locked records 
are unlocked. 

If FCB interface attribute f5 is set, this 
function performs a "partial close" operation 
which updates the directory but leaves the 
file open. 
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C-Function 17 
Search for First 


Copyright 1984 by software 2000, Inc. 
All rights reserved. 


C-Function 17 

Entry Arguments 


Returned Value 


Explanation 


Search for First 


Reg 1__ 

Description_ 

r> _ 1 "7 

^ — J. / 

DE = FCB address 


Reg 1 

_______ Description 

A = entry 

number (0-3) if successful 

-1 if 

file not found 


The Search for First function scans the 
directory for the first entry which matches 
the FCB drive, name, type, and extent fields 
(bytes 0 through 12) and the current user 
number. An ASCII question mark (3FH) in any 
FCB byte 1 through 12 is treated as a wild¬ 
card which matches any character in the cor¬ 
responding byte position of the directory 
entry. 

If the search is successful, this function 
returns a directory record (containing four 
32-byte directory entries) at the current DMA 
address, and with a value in register A (0-3) 
that indicates which of the four entries was 
found to match the FCB. If the search is not 
successful, the function returns -1 (OFFH) in 
register A. 

If the Search for First function succeeds in 
finding an entry which matches the given FCB, 
then C-function 18 (Search for Next) may be 
called repeatedly to locate all remaining 
matches in the directory. 
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C-Function 17 
Search for First 
(Continued) 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


A special situation occurs if the FCB drive 
field (byte 0) is set to a question mark 
(3FH). In this case, the remainder of the 
FCB is ignored, the directory of the current 
drive is searched, and the Search for First 
function returns the very first directory 
entry (usually the volume label). The Search 
for Next function will then return each suc¬ 
cessive directory entry in sequence, regard¬ 
less of user number. Even deleted entries 
are returned in this case. 
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C-Function 18 
Search for Next 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 18 Search for Next 



Returned Value 



_D£S£J±pti 



I A = entry number (0—3) if successful 
I -1 if file not found 


Explanation The Search for Next function continues the 

search initiated by C-function 17 (Search for 
First). If the search is successful, this 
function returns a directory record (contain¬ 
ing four 32-byte directory entries) at the 
current DMA address, and with a value in 
register A (0-3) that indicates which of the 
four entries was found to match the FCB. If 
the search is not successful, the function 
returns -1 (0FFH) in register A. 
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Delete File 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 19 Delete File 


Entry Arguments I Reg 1_Desc.rip.ti.QJl 

I 

I C = 19 
I DE = FCB address 


Returned Value 1 Reg I ___Pe.scx. i pt.iQD— 

I 

I A = 0 if successful 
I -1 if no file was deleted 


Explanation The Delete File function deletes the file 

specified by the FCB drive, name, and type 
fields (bytes 0 through 11) and the current 
user number. ASCII question marks (3FH) may 
be used as wild-cards anywhere in the FCB 
name and type fields, in which case this 
function deletes all matching files. 

A program may delete a file that it has open, 
in which case a close is performed implicitly 
before the file is deleted. However, a pro¬ 
gram is not permitted to delete a file that 
another process has open, nor a file that has 
the read-only or FIFO attributes. 

If FCB interface attribute f5 is set, this 
function performs no operation and returns 
A=0 to indicate successful completion. (This 
is for compatibility with M/PM, where the f5 
attribute causes only XFCBs to be deleted.) 
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C-Function 20 
Read Sequential 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 20 


Read Sequential 


Entry Arguments I Reg I _ Description _I 

! I 
j C = 20 i 
I DE = FCB address I 


Returned Value 1 R eg I___ De scription_I 

I A = 0 if successful I 
I 1 if at end-of-file I 
I 128 if FCB current record invalid I 


Explanation The Read Sequential function reads the next 

one or more 128-byte records from a file into 
memory starting at the current DMA address. 
The number of records to be read (up to 128) 
is determined by C-function 44 (Set Multi- 
Sector Count). The default is one record. 

The given FCB must have been previously 
opened by an Open (15) or Make (22) C-func¬ 
tion, and the FCB current record field (byte 
32) initialized to zero. 

This function uses the FCB extent and current 
record fields to determine the record to be 
read, then increments the current record 
field in preparation for the next sequential 
operation. If the current record field over¬ 
flows, the next extent is opened and the 
current record field is reset to zero. 

If the file being read is a FIFO, records are 
read from the beginning and removed from the 
FIFO. Reading an empty FIFO either suspends 
or returns end-of-file (A=l) depending upon 
the mode byte in the FIFO header. However, 
if FCB interface attribute f5 is set, reading 
an empty FIFO always returns end-of-file. 
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C-Function 21 
Write Sequential 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 21 Write Sequential 

Entry Arguments 


Returned Value 


Explanation The Write Sequential function writes the next 

one or more 128-byte records of a file from 
memory starting at the current DMA address. 
The number of records to be written (up to 
128) is determined by C-function 44 (Set 
Multi-Sector Count). The default is one. 

The given FCB must have been previously 
opened by an Open (15) or Make (22) C-func¬ 
tion, and the FCB current record field (byte 
32) initialized to zero. This function uses 
the FCB extent and current record fields to 
determine the record to be write, then incre¬ 
ments the current record field in preparation 
for the next sequential operation. If the 
current record field overflows, the next 
extent is opened (or created if it does not 
exist) and the current record is zeroed. 

If the file being written is a FIFO, records 
are appended to the end. Writing a full FIFO 
either suspends or returns disk-full (A=2) 
depending on the FIFO header mode byte. How¬ 
ever, if FCB interface attribute f5 is set, 
writing a full FIFO always returns disk-full. 



C = 21 

DE = FCB address 


_B£g_ i_P£scxiptipn_ 

A = 0 if successful 

1 if file too large 0134 Mb) 

2 if disk full or file read-only 

8 if attempt to write locked record 
128 if FCB current record invalid 
-1 if no directory space 
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C-Function 22 
Make File 


Copyright 1984 by Software 2000, Inc. 

All rights reserved. 

C-Function 22 

Make File (cfi.tr i Eic-t) 

Entry Arguments 

1 Req 

J_ Description_ 1 

j 

i C 

1 DE 

1 

1 

= 22 i 

= FCB address 1 

1 




Returned Value 

! Rea 

J_Description_____1 

1 

1 A 

1 

1 

1 

1 

= 0 if successful ! 

-1 if directory full, file exists, 1 
or FCB invalid 1 

1 


Explanation The Make File function creates a new (empty) 

file specified by the FCB drive, name, type, 
and extent fields (bytes 0 through 12). Nor¬ 
mally, the extent field (byte 12) should be 
set to zero. The directory entry for the new 
file is placed under the current user number. 
All file attributes are initialized to zero. 
A request to make a file that already exists 
is denied. 

The newly-created file is left in an open 
state. If the FCB interface attribute f5 is 
set, then the file is left open in shared 
mode. Otherwise, the file is left open in 
either exclusive or permissive mode, depend¬ 
ing on compatibility flag bit 7 (permissive). 

The calling program should zero the FCB cur¬ 
rent record field (byte 32) before doing 
sequential reads or writes on the file. 
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C-Function 23 
Rename File 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 23 Rename File 


Entry Arguments I Reg J_ Description. 

I 

I C = 23 
I DE = FCB address 


Returned Value 


Explanation 


_ _ D.egc_xiptiPR. 


i A = 0 if successful 

I -1 if file not found, file in-use, 

I or file name invalid 




The Rename File function renames the file 
specified by the FCB drive, name, and type 
fields (bytes 0 through 11) and the current 
user number. The file is given the new name 
and type specified in bytes 17 through 27 of 
the FCB. Wild-card characters (ASCII ques¬ 
tion marks) are not allowed in either the old 
or new name. All remaining bytes of the FCB 
are disregarded by this function. 

A program may rename a file that it has open, 
in which case a close is performed implicitly 
before the file is renamed. However, a pro¬ 
gram is not permitted to rename a file that 
another process has open, nor a file that has 
the read-only attribute. 
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C-Function 24 Return Login Vector 


Entry Arguments 


Rea 1 

_Description_ 

n — n A 

V/ - 4.1 



Returned Value I Reg I _Dg£.cjip£i3H_j 

I HL = login vector i 

i_______i 

Explanation The Return Login Vector function tests the 

ready status of all disk drives. It returns 
a 16-bit vector in register HL containing a 
one-bit for each drive that is ready for 
access, and a zero-bit for each drive that is 
not ready or not defined. The least signifi¬ 
cant bit corresponds to drive A, and the most 
significant bit to drive P. 

NOTE: This function is supported only if the 

optional module CPMSUP is included during 
TurboDOS system generation. 

f -TV ^ 3 {$ ib • ■' 1 ° 1 ' *-« ' ‘ " 5 • 1 : 1 r ■' ' 

6 r -v tt 1 ^ -e 

^ >*- raff’C 1 ? r/o>; a 
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C-Function 25 
Return Current Disk 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 25 

Entry Arguments 


Returned Value 


Explanation 


Return Current Disk 


Reg 

| 

_ Description_ 

C 

= 25 



Reg 1_ _Description _ _ 

A 

= current 
(>h 0 for 

1 for 

disk drive: 
drive A 
drive B 


of,* 15 for 

drive P 


The Return Current Disk function returns the 
identity of the current (default) disk drive 
in register A. 
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C-Function 26 
Set DMA Address 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Explanation The Set DMA Address function causes the 

memory address specified in register DE to be 
used as the record buffer address for 
subsequent file read and write operations. 
In a banked memory system, the DMA address is 
always interpreted as an address in the same 
memory bank as the TPA. 

Whenever a program is loaded into the TPA, 
the DMA address is initialized to 0080H, the 
address of the default record buffer in the 
Base Page. C-function 13 (Reset Disk System) 
also sets the DMA address to 0080H. 
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C-Function 27 
Get ALV Address 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 27 Get ALV Address * V ~ > )r 

Entry Arguments I Reg 1_ Description _ 

I 

I C = 27 


Returned Value I Reg 1_ 



Explanation This function performs no operation in Turbo¬ 

DOS. (Under CP/M, it returns the address of 
the memory-resident allocation vector for the 
current disk.) 


4-30 



TurboDOS 1.4 Z80 
Programmer's Guide 


C-FUNCTIONS 


C-Function 28 
Write Protect Disk 


Copyright 1984 by software 2000, inc. 
All rights reserved. 


C-Function 28 


Write Protect Disk 


Entry Arguments 


Heg. 



^ n 


— ZO 




Explanation 


The Write Protect Disk function marks the 
current (default) disk drive as read-only, 
preventing any program from writing to the 
disk. C-function 37 (Reset Drive) must be 
used to enable writes to the disk once again. 

Unlike CP/M, TurboDOS does not re-enable 
writing after warm-start, C-function 0 (Sys¬ 
tem Reset), or C-function 13 (Reset Disk 
System). Consequently, write-protection of a 
disk drive is not nearly so temporary as it 
is in CP/M. 


NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. , . 

/,W . 




/ 


bo 'fe 




\A* * f~e & f ’ * 
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C-Function 29 
Get Read-Only Vector 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 29 


Get Read-Only Vector 


Entry Arguments 


Rea 1 

Description_ 

C = 29 



Returned Value I Reg I _HaSILEip.tiQn -- 

I 

I HL = read-only vector 


Explanation The Get Read-Only Vector function returns a 

16-bit vector in register HL containing a 
one-bit for each disk drive that is write- 
protected, and a zero-bit for each drive that 
is not. The least significant bit corres¬ 
ponds to drive A, and the most significant 
bit to drive P. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-Funetion 30 
Set File Attributes 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 30 

Entry Arguments 


Returned Value 


Set File Attributes 


R..e.g. 




c - 30 

DE = FCB address 


J___D^scjiptlpji, 


A = 0 if successful 

-1 if file not found or in-use 


Explanation 


The Set File Attributes function searches the 
directory for the file specified by the FCB 
drive, name, and type fields (bytes 0 through 
11) and the current user number, and updates 
the file attributes in the directory from 
those in the FCB. (File attributes are 
stored in the high-order bit of FCB bytes 1-4 
and 9-11.) 

In addition, if FCB interface attribute f6 is 
set, this function updates the last record 
byte count of the file. The count is ob¬ 
tained from the current record field (byte 
32) of the FCB, and stored in the sped field 
(byte 13) of each directory entry. 

A program may set attributes on a file that 
it has open, in which case a close is per¬ 
formed implicitly before the attributes are 
set. However, a program is not permitted to 
set attributes on a file that another process 
has open. 


^ r <-> r 
imV * 




c *+■ . 






i - 

r -) -y 
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C-Function 31 
Get DPB Address 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 31 


Get DPB Address 


Entry Arguments 


1 Reg 1_Pg-SC-EiP-ti.QH 

I 

I C * 31 

I __ „„_ 


I 

I 


I 


Returned Value 


Explanation 


I Reg 1 _PePCXlptiDD_I 

I I 

I HL = DPB address I 


The Get DPB Address function causes TurboDOS 
to construct a CP/M-style Disk Parameter 
Block (DPB) for the current drive, and to 
return its memory address in register HL. 

NOTE: This function is supported only if the 

optional module CPMSUP is included during 
TurboDOS system generation. 

• f 1 1 1 , ., ’ 

■ * " r r >■■ .» (, ■ ./i h- “j/? * 


0*2* wr 
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C-Function 32 
Get/Set User Number 


Copyright 1S84 by Software 2000, Inc. 
All rights reserved. 


C-Function 32 
Entry Arguments 


Get/Set User Number 



I E = -1 to get user number 
I 0-31 to set user number 



Explanation The Get/Set User Number function can be used 

either to set or to return the current user 
number. If the value -1 (OFFH) is passed in 
register E, this function returns the current 
user number in register A. If some other 
value is passed in register E and if the 
caller is a privileged log-on, this function 
sets the current user number to the specified 
value (modulo 32). A request to set the 
current user number from a non-pr ivileged 
log-on is ignored. 
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C-Function 33 
Read Random 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


Read Random 


! Reg ~ ~ Description 

I C = 33 

I DE = FCB address 


I. Reg. J..Pescxiption„_ 

I A = 0 if successful 
I 1 if reading unwritten data 

I 3 if error changing extents 

I 4 if reading unwritten extent 

I 6 if random record number invalid 


Explanation The Read Random function reads one or more 

consecutive 128-byte records from a file into 
memory starting at the current DMA address. 
The number of records to be read (up to 128) 
is determined by C-function 44 (Set Multi- 
Sector Count). The default is one record. 

The first record to be read is specified by a 
20-bit random record number obtained from the 
FCB random record field (bytes 33 through 
35). The given FCB must have been previously 
opened by an Open (15) or Make (22) C-func¬ 
tion. 

This function sets the FCB extent and current 
record fields to correspond with the record 
that was read. Unlike C-function 20 (Read 
Sequential), however, it does not increment 
the current record field after reading. 
Thus, if the Read Random function is followed 
by a Read Sequential or Write Sequential, the 
same record is re-accessed. 


I 


I 

I 


C-Function 33 

Entry Arguments 


Returned Value 
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Write Random 
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C-Function 34 Write Random 


Entry Arguments I Reg J__B. e££ j:i p . ti j QB - 

! 

i C =34 

I DE = FCB address 


Returned Value LReg_J>___J 3 escjj.ptj.pri--1 

I I 

1 A = 0 if successful I 

I 2 if disk full or vjrite-protected I 

I 3 if error changing extents I 

I 5 if no directory space I 

I 6 if random record number invalid i 

I 8 if writing locked record I 


Explanation The Write Random function writes one or more 

consecutive 128-byte records of a file from 
memory starting at the current DMA address. 
The number of records to be written (up to 
128) is determined by C-function 44 (Set 
Multi-Sector Count), The default is one 
record. 

The first record to be written is specified 
by a 20-bit random record number obtained 
from the FCB random record field (bytes 33 
through 35). The given FCB must have been 
previously opened by an Open (15) or Make 
(22) C-function. 

This function sets the FCB extent and current 
record fields to correspond with the record 
that was written. Unlike C-function 21 
(Write Sequential), however, it does not 
increment the current record field after 
writing. Thus, if the Write Random function 
is followed by a Read Sequential or Write 
Sequential, the same record is re-accessed. 
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C-Function 35 
Compute File Size 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 35 Compute File Size 



Returned Value 


Explanation 




I A = 0 if successful 
I -1 if file not found 



The Compute File Size function searches the 
directory for the file specified by the FCB 
drive, name, and type fields (bytes 0 through 
11). If the file is found, this function 
sets the FCB random record field (bytes 33 
through 35) to a value one greater than the 
record number of the last record in the file. 
Thus, a succeeding Write Random function (34) 
will append an additional record at the end 
of the file. 


In TurboDOS, the Compute File Size function 
returns the correct result whether the file 
is open or closed. 

(^ k -V)> 1Cf \ ' l <; j‘*. f s .« 
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C-Function 36 
Set Random Record 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 36 

Entry Arguments 


Explanation 


Set Random Record 


I -Rag. ...I__■DaS-CJip.tiafl. 

I 

I n -*./■* 

I C = JD 

I DE = FCB address 


The Set Random Record function returns the 
current file position of an open file in the 
random record field (bytes 33-35) of the FCB. 
(The file position is determined from the 
values of the FCB extent, spec2, and current 
record fields.) Since the Read Sequential 
(20) and Write Sequential (21) functions do 
not update the random record field of the 
FCB, this function is useful when switching 
from sequential to random access. 
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C-Function 37 
Reset Drive 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 37 


Reset Drive 


Entry Arguments 


Re g I „ ____Desc ription. 

C = 37 

DE = reset vector 


Explanation The Reset Drive function write-enables the 

disk drives specified by the 16-bit reset 
vector passed in register DE. The reset 
vector contains a one-bit for each disk drive 
that is to be write-enabled, and a zero-bit 
for each drive that is not. The least signi¬ 
ficant bit corresponds to drive A, and the 
most significant bit to drive P. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 


4-40 






TurboDOS 1.4 Z80 
Programmer's Guide 


C-FUNCTIONS 


C-Function 40 
Write Random 0-Fill 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 40 Write Random with Zero Fill 


Entry Arguments 


l. Feg_ J__ Desc riptlm 

! 

I C = 40 
I DE = FCB address 


Returned Value 


Explanation 


I 

I 

I 


A = 



_ _JD escxip.ti.QB_.___I 

0 if successful I 

2 if disk full or write-protected I 

3 if error changing extents I 

5 if no directory space I 

6 if random record number invalid I 

8 if writing locked record I 


The Write Random with Zero Fill function is 
implemented in TurboDOS as a synonym for 
Write Random (C-function 34). 
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C-Function 42 
Lock Record 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 42 


Lock Record 


Entry Arguments 



__ P£5.cj:iP-tl.Qn. 


C = 42 

DE = FCB address 


Returned Value 


Reg I_D^scxiption.__ 

A = 0 if successful 

1 if positioning to unwritten data 

3 if error changingextents 

4 if positioning to missing extent 
6 if random record number invalid 
8 if locked by another process 


Explanation The Lock Record function attempts to obtain a 

lock on one or more consecutive records, 
starting with the 20-bit random record number 
obtained from FCB random record field (bytes 
33 through 35). The number of records locked 
(up to 128) is determined by C-function 44 
(Set Multi-Sector Count). The default is one 
record. The given FCB must have been pre¬ 
viously opened in shared mode. If the file 
is not open in shared mode, this function 
performs no operation and returns A=0. 

The file is positioned to the specified 
record, unless compatibility flag bit 3 
(logical) is set or the file is a FIFO. If 
the record is already locked by another 
process, this function either suspends or 
returns an error (A=8) depending on the set¬ 
ting of compatibility flag bit 6 (suspend). 

If the FCB random record field is set to the 
24-bit value OFFFFFFH, then this function 
attempts to obtain an all-inclusive lock (on 
all records of the file at once). In this 
case, no positioning is performed. 
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C-Function 43 
Unlock Record 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 43 


Unlock Record 


Entry Arguments 


I Reg 

i 

i 

I C 
I DE 


_Descri pt ion_I 

43 i 

FCB address ! 

_I 


Returned Value L Res. J_ __Des criptio n_! 

I A = 0 if successful I 
I 1 if positioning to unwritten data I 
I 3 if error changing extents I 
i 4 if positioning to missing extent I 
I 6 if random record number invalid I 


Explanation The Unlock Record function unlocks one or 

more consecutive records, starting with the 
20-bit random record number obtained from FCB 
random record field (bytes 33 through 35). 
The number of records unlocked (up to 128) is 
determined by C-function 44 (Set Multi-Sector 
Count). The default is one record. Attempt¬ 
ing to unlock a record which was not pre¬ 
viously locked does not return an error. The 
given FCB must have been previously opened in 
shared mode. If the file is not open in 
shared mode, this function performs no opera¬ 
tion and returns a successful result. 

The file is positioned to the specified 
record, unless compatibility flag bit 3 
(logical) is set or the file is a FIFO. 

If the FCB random record field is set to the 
24-bit value OFFFFFFH, then this function 
releases any all-inclusive lock on the file, 
but does not affect any individual record 
locks. In this case, no positioning is per¬ 
formed. 
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C-Function 44 
Set Multi-Sector Cnt 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


KfoCo (Cfc> 

C-Function 44 Set Multi-Seetor Count 


Entry Arguments I Reg 1 ___ Descr iption._ _I 

I I 

I C = 44 I 

I E = number of records (1-128) I 


Returned Value 


Explanation 


1 Reg 1__D e s c ription._ 

I 

I A = 0 


fUcoA-b 

The Set Multi-Seeder Count function enables a 
program to read or write up to 128 records at 
a time during subsequent file operations. 
This function affects subsequent calls to the 
following C-functions: 


C-Fun ction J_ Description. 


20 

Read 

Sequential 

21 

Write 

Sequential 

33 

Read 

Random 

34 jH° 

Write 

Random 

42 

Lock 

Record 

43 

Unlock Record 


and establishes the number of consecutive 
128-byte records to be read, written, locked 
or unlocked. Once set, the specified record 
count remains in effect until changed by 
another Set Multi-Silver Count C-function. 
The initial default value is one record. 

■■ . n e i .... ] r J . -r , "~3 >" f ' ‘ - •''' 

f Y 3 j v { y- - '' 

v ' ■' -S’ V - [ i V f T f ‘ 
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C-Function 46 
Get Disk Free Space 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 



Returned Value I Reg J _ Desc ription 

I 

I A = 0 


Explanation The Get Disk Free Space function determines 

the amount of free space on the specified 
disk drive. It returns a 24-bit binary value 
(the number of free 128-byte records) as a 
three byte quantity stored at the current DMA 
address, least significant byte first. 
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C-Function 47 
Chain to Program 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 47 

Entry Arguments 


Explanation 


Chain to Program 



E = 0 to revert to original disk/user 
-1 to retain current disk/user 


The Chain to Program function provides a 
means of chaining from one program to 
another. The calling program must place a 
valid TurboDOS command line, terminated by a 
null byte, in the Base Page record buffer 
starting at location 0080K. This function 
terminates the calling program, and then 
executes the command line. The commands are 
echoed to the console as they are executed, 
unless the command line starts with a command 
separator (backslant) character. 

If E = 0, the current disk and current user 
number reverts to what it was when the 
calling program was originally loaded into 
the TPA (the normal warm-start procedure). 
If E = -1, however, the current disk and 
current user number at the time of call is 
retained. 
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C-Function 104 
Set Date and Time 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 104 

Entry Arguments 


Explanation 


Set Date and Time 


I Reg I __H^SCjjLption- 

I 

i C = 104 

i DE - date/time packet address 


The Set Date and Time function sets the 
system date and time. The address of a four— 
byte date/time packet is passed in DE. The 
date/time packet has the following structure: 


Offset_l_„_Description- 

0-1 Date, represented as a 16-bit 
Julian date with 0000H corre¬ 
sponding to 31 December 1977. 

2 Hours, represented as two binary 
coded decimal (BCD) digits 

3 Minutes, represented as two bi¬ 
nary coded decimal (BCD) digits 


Seconds are set to zero, 


fa/H - use 5 ? 




1 p . yin py o a f 3 «■ 
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C-Function 105 
Get Date and Time 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 105 Get Date and Time 

Entry Arguments l_Re. g . 1 _ 

I 

I C = 105 

I DE = date/time packet address 


Returned Value l__Beg__Descriptio n _ _I 

I I 

I A = seconds (two BCD digits) I 

Explanation The Get Date and Time function returns the 

system date and time in a four-byte date/time 
packet whose address is passed in DE. The 
date/time packet has the following structure: 


. Offset, J.Descr ipt ion __ 

0-1 Date, represented as a 16-bit 
Julian date with 0000H corre¬ 
sponding to 31 December 1977. 

2 Hours, represented as two binary 
coded decimal (BCD) digits 

3 Minutes, represented as two bi¬ 
nary coded decimal (BCD) digits 


Seconds are returned in register A, represen¬ 
ted as two binary coded decimal (BCD) digits. 
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C-Function 107 
Return Serial Number 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 107 


cvr 

Return^Serial Number 


Entry Arguments 


cjripii oil._ 

C = 107 

DE = address of 6-byte S/N field 


Explanation The Return Serial Number function returns the 

CP/M serial number in the 6-byte field whose 
address is passed in DE. Under TurboDOS, 
this function always returns six zero bytes. 

NOTE: This function is supported only if the 
optional module CPMSUP is included during 
TurboDOS system generation. 
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C-Function 108 
Get/Set Return Code 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 108 

Entry Arguments 


Get/Set Program Return Code 


I. Reg. J 


. Descjiptipji_ 


c = 108 

DE = 0FFFFH (if get) 

program return code (if set) 


Returned Value 


Explanation 


i. Reg_J..._.. Description._ 

! HI ~ program return code (if get) 


The Get/Set Program Return Code 
provides a means for one program 
16-bit value to another program, 
ample, this function can be used to 
in connection with C-function 47 
Program). 


function 
to pass a 
For ex¬ 
advantage 
(Chain to 


If register DE is set to 0FFFFH, then this 
function interrogates the program return code 
and returns it in register HL. Otherwise, 
this function sets the program return code to 
the value passed in register DF. 




1*1 U r / *J ^ t ■» >■ 


■V ‘ "■ ' •’ -* ' r* 

7 /s, rk 


3 :S ' 


• c w r* *•> np ' **■ . 


V 1 -J t. , O 4 * $ > 
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C-Function 110 
Get/Set Delimiter 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 110 Get/Set Program Output Delimiter 


Entry Arguments I Reg I___D escription _I 

! I 
i C = 110 i 
I DE = 0FFFFH (if get), or I 
I E = output delimiter (if set) I 


Returned Value 


Explanation 


I. -R-eg-J_ _ _Pgscjlp.tl.on. ......I 

I ! 

I A = output delimiter (if get) I 


The Get/Set Output Delimiter function can be 
used to set or interrogate the output delimi¬ 
ter used by C-function 9 (Print String). 
Whenever a program is loaded into the TPA, 
the output delimiter is initialized to the 
dollar sign $ character. 


If register DE is set to 0FFFFH, then this 
function interrogates the current output 

a ri n r ri f n r n c *i4- i n rDOi A 

V. X J. All X C- C i. U ii V X V- U U J. 11 U X U JL ii 4-V^JXI^UCi. *1 • 

Otherwise, this function sets the output 
delimiter to the value passed in register E. 


'■Jb* 

lo ^ ' 

*r) 

i 

cb/ lot> 


■jo/" 2-/3 ■?. t 

-r\ \ 

r i/y- > 

f'jt 't* a". $ • fl f P 






^rx 


^ i-e 


! 

r\a> 


OM „ 
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C-Function 111 
Print Block 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 111 

Entry Arguments 


Explanation 


Print Block -fa 

I - Reg . .1_be^cjipiipn_ 

I 

I C - 111 
I DE = CCB address 


The Print Block function displays a string 
of characters on the console screen. The 
string may be of any length, and is defined 
by a Character Control Block (CCB) whose 
address is passed in register DE. The 
CCB is four bytes long, and has the following 
structure: 


Offset I 

0-1 starting address of string 

2-3 byte-length of string 



Horizontal tabs are expanded into multiple 
spaces, based upon tab stops at every eighth 
column. 
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C-Function 112 
List Block 


copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 112 List Block Jv bfu/c-e 


Entry Arguments | _Reg 1 ~ ~ r i pj- j 

I n _ i t a 

I = JLJ.Z 

I DE = CCB address 


Explanation The List Block function sends a string of 

characters to be printed according to the 
current print routing. The string may be of 
any length, and is defined by a Character 
Control Block (CCB) whose address is passed 
in register BE. The CCB is four bytes long, 
and has the following structure: 


■Offsets___Descri ption „ __ 

0-1 starting address of string 

2-3 byte-length of string 


Horizontal tabs are not expanded. 
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C-Function 134 
Make Queue 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 134 

Entry Arguments 


Make Queue 


Re g 1 ..P.es.cjiptjpn.._ 

C = 134 

DE = QD address 


Returned Value 


_ Reg. J___ Pescjj.pjtj.pn_ 

A = 0 if successful 

-I if cannot make queue 


Explanation The Make Queue function emulates the creation 

of an MP/M queue defined by a Queue Descrip¬ 
tor (QD) whose address is passed in register 
DE. The QD has the following structure: 


Qifsp. t . . 1 _Ppscjj.ptj.pn_ ^._- 

0-1 zeroes (internal use) 

2-9 queue name in ASCII (8 chars) 

10-11 message length 

12-13 maximum number of messages 


This function causes TurboDOS to create a RAM 
FIFO having the given queue name (mapped to 
upper case) and type ".QUE" on the system 
disk (patch QUEDRV to change) under user 0 
with the "global" attribute. Any file with 
the same name is deleted. Within the FIFO, 
the message length is rounded up to the next 
multiple of 128 bytes (and must not exceed 
256 bytes if accessed from a banked TPA). 
The maximum number of messages must not 
exceed the capacity of a RAM FIFO (16,256 
bytes) and is rounded down as necessary. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in¬ 
cluded during TurboDOS system generation. 
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C-Function 135 
Open Queue 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 135 Open Queue 

Entry Arguments 1 Reg I _„__I 

I I 

l r s v* * 1 

» v/ — a. s/ ^ • 

! DE = QPB address I 


Returned Value I Rea I _ Des cri ption 

i 

I A = 0 if successful 
I -1 if cannot open queue 


Explanation The Open Queue function opens an emulated 

MP/M queue. The queue is defined by a Queue 
Parameter Block (QPB) whose address is passed 
in register DE. The QPB is 12 bytes long, 
and has the following structure: 


_ Off set .1 

0-1 queue pointer 

2-3 buffer address 

4-11 queue name in ASCII (8 chars) 


This function causes TurboDOS to open a RAM 
FIFO having the given queue name (mapped to 
upper case) and type ".QUE" as previously 
created by Make Queue (C-function 134). The 
Open Queue function fills in the "queue poin¬ 
ter" field of the QPB, and ignores the 
"buffer address" field. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in¬ 
cluded during TurboDOS system generation. 
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C-Function 136 
Delete Queue 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 136 


Delete Queue 


Entry Arguments 1 Reg I___ Description _I 

I I 
I C = 136 I 
I DE = QPB address I 


Returned Value 


I . Reg. J ___P£S£xj.ptiJ>Ji___„, 

I 

I A = 0 if successful 
I -I if cannot delete queue 


Explanation The Delete Queue function deletes an emulated 

MP/M queue. The queue is defined by a Queue 
Parameter Block (QPB) whose address is passed 
in register DE. The QPB is 12 bytes long, 
and has the following structure: 


_ Off set 1 _ Descriptio n_ 

0-1 queue pointer 

2-3 buffer address 

4-13 queue name in ASCII (8 chars) 


The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Delete 
Queue function causes TurboDOS to close the 
queue and delete the associated RAM FIFO. 
The "buffer address" and "queue name" fields 
of the QPB are ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in¬ 
cluded during TurboDOS system generation. 
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C-Function 137 
Read Queue 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 137 Read Queue 


Entry Arguments I Reg . J___Descr iption__ 1 

I I 

i i ^ i 

J = ±3 / I 

I DE = QPB address I 


Returned Value i Reg 1 _ _ _ D escription 

I 

I A = 0 if successful 
1 -1 if queue not open 


Explanation The Read Queue function reads a message from 

an emulated MP/M queue. The queue is defined 
by a Queue Parameter Block (QPB) whose 
address is passed in register DE. The QPB is 
12 bytes long, and has the following 
structure: 


.Offset- J_Description___ 

0-1 mipno nr, i nf pr 

V .JL. V/ O. 1 A W V. i. 

2-3 buffer address 

4-11 queue name in ASCII (8 chars) 



The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Read 
Queue function reads a message from the queue 
into memory starting at the "buffer address" 
specified in the QPB. If the queue is empty, 
the calling program is suspended until a 
message becomes available. The "queue name" 
field of the QPB is ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in¬ 
cluded during TurboDOS system generation. 
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C-Function 138 
Cond. Read Queue 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 138 Conditional Read Queue 


Entry Arguments I Reg I __ . _ _I 

I I 

I C = 138 I 

I DE = QPB address I 


Returned Value 


Explanation 


I. Reg_ J_ _ _ Pescxipiipn_I 

I I 
I A = 0 if successful I 
I -1 if queue empty or not open I 


The Conditional Read Queue function reads a 
message from an emulated MP/M queue. The 
queue is defined by a Queue Parameter Block 
(QPB) whose address is passed in register DE. 
The QPB is 12 bytes long, and has the fol¬ 
lowing structure: 


J__ ReRcxipixon_ 

0-1 queue pointer 

2-3 buffer address 

4-11 queue name in ASCII (8 chars) 


The QPB must have been previously opened with 
Open Queue (C-functior. 135) so that the QPB 
"queue pointer" field is valid. The Condi¬ 
tional Read Queue function reads a message 
from the queue into memory starting at the 
"buffer address" specified in the QPB. If 
the queue is empty, the function returns 
immediately with a failure indication (A=-l). 
The "queue name" field of the QPB is ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in¬ 
cluded during TurboDOS system generation. 


4-58 









TurboDOS 1.4 Z80 
Programmer's Guide 

Copy 


C-Function 139 

Entry Arguments 


Returned Value 

Explanation 


C-FUNCTIONS 

C-Function 139 
Write Queue 


ght 1984 by Software 2000, Inc. 
All rights reserved. 


Write Queue 


I - R eg, . 1 __Dasoripiloji 

! 

1 /I 1 ^ A 

i c = 

i DE = QPB address 


I 


I _ Reg. J_ Des cription___I 

I I 
! A = 0 if successful I 
I -1 if queue not open 1 


The Write Queue function writes a message to 
an emulated MP/M queue. The queue is defined 
by a Queue Parameter Block (QPB) whose 
address is passed in register DE. The QPB is 
12 bytes long, and has the following 
structure: 


Offset J___Description__- 

0-1 queue pointer 

2-3 buffer address 

4-11 queue name in ASCII (8 chars) 


The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Write 
Queue function writes a message to the queue 
from memory starting at the "buffer address" 
specified in the QPB. If the queue is full, 
the calling program is suspended until space 
becomes available in the queue. The "queue 
name" field of the QPB is ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in¬ 
cluded during TurboDOS system generation. 
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C-Function 140 
Cond. Write Queue 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 140 Conditional Write Queue 


Entry Arguments I Rejg 1 _ Desc rip tio n_I 

I C = 140 I 

I DE = QPB address I 


Returned Value 


I. Reg. .1_ __ Desc r iption _I 

I I 
I A = 0 if successful ! 
I -1 if queue full or not open I 


Explanation The Conditional Write Queue function writes a 

message to an emulated MP/M queue. The queue 
is defined by a Queue Parameter Block (QPB) 
whose address is passed in register DE. The 
QPB is 12 bytes long, and has the following 
structure: 


0-1 queue pointer 

2-3 buffer address 

4-11 queue name in ASCII (8 chars) 


The QPB must have been previously opened with 
Open Queue (C-function 135) so that the QPB 
"queue pointer" field is valid. The Condi¬ 
tional Write Queue function writes a message 
to the queue from memory starting at the 
"buffer address" specified in the QPB. If 
the queue is full, the function returns imme¬ 
diately with a failure indication (A=-l). 
The "queue name" field of the QPB is ignored. 

NOTE: This function is supported only if the 
optional modules QUEMGR and MPMSUP are in¬ 
cluded during TurboDOS system generation. 
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C-Function 141 
Delay 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 141 Delay 


Entry Arguments I Reg I _De scr j. p£i oil _ _I 

j I 

i C = 141 i 

i DE = tick count I 


Explanation 


The Delay function causes the calling process 
to be suspended for the period of time 
specified by the tick count passed in 
register DE. A system "tick" is an implemen¬ 
tation-dependent time interval, usually 1/50 
or 1/60 of a second. The actual delay may 
vary from the requested tick count by plus or 
minus one tick. 


If the specified tick count is zero, then the 
calling program is suspended only long enough 
to allow any other ready processes to run (a 
so-called "courtesy" dispatch). 


NOTE: This function is supported only if the 

optional module MPMSUP is included during 
TurboDOS system generation* 

/) of 0 »!*/•* ^ t'^ 1 ^ ^ 

\^r{ f? <U/r.L , 


Kiftfa ' fr<3’ w SC) *5 ■*) 
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C-Function 142 
Dispatch 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 142 

Entry Arguments 


Explanation 


Dispatch 


l-iteg. .1_P££cjip.tim 

I 

l c = 142 


The Dispatch function causes the calling 
process to be suspended only long enough to 
allow any other ready processes to run (a so- 
called "courtesy" dispatch). 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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C-Function 143 
Terminate 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


C-Function 143 Terminate 


Entry Arguments 


Reg 


D .es. c .r,ip,ti£iL 


^ = 


Explanation The Terminate function terminates the calling 

program ("warm-start"). It is honored for 
transient programs only, and is equivalent to 
System Reset (C-function 0).* 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 
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Parse Filename 


Copyright 1984 by Software 2000, Inc. 
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C—Function 152 Parse Filename 


Entry Arguments 


Reg 


I C = 152 
I DE = PFCB address 


I 


Returned Value I.Reg I _ Description _I 

I I 
I HL = 0 if successful and end of line I 
I OFFFFH if error while parsing I 
I delimiter address otherwise I 
I DE = delimiter address I 


Explanation The Parse Filename function parses an ASCII 

file specification into FCB format. The 
function is called with the address of a 
Parse Filename Control Block (PFCB) in DE. 
The PFCB is four bytes long, and has the 
following structure: 


jQ££s.ejL I __ _Description.___ 

0-1 address of ASCII input string 

2-3 address of destination FCB 


This function parses the first file 
specification it finds in the input string. 
Leading spaces are ignored. Parsing stops 
upon encountering a space, comma, semicolon, 
equal-sign, or any ASCII control character. 

The Parse Filename function parses an ASCII 
file specification of the form: 


I (ud:}filenamef.typ} 
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Parse Filename 
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C-Function 152 where "filename" is a name up to 8 characters 

long, ".typ" is an optional type up to 3 
characters long, and "ud:" is an optional 
user/drive prefix taking one of the following 
six forms: 


I uu: d: uud: duu: uu:d: d:uu: 


where "uu" is a decimal user number (0-31) 
and "cl" is a drive letter (A-P) . 

The FCB drive, name, and type fields (bytes 0 
through 11) are initialized according to the 
parsed file specification. FCB bytes 12 and 
14 are zeroed. In the absence of a user 
number prefix, FCB bytes 13 and 15 are also 
zeroed. If the file specification includes a 
user number prefix, however, FCB byte 13 is 
set to the given user number, and FCB byte 15 
is set to -1 (OFFH). 
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C-Function 153 
Get Console Number 
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C-Function 153 


Get Console Number 


Entry Arguments 


I Reg 1__ Das£1 iptiPD_ 

I 

I C =153 


Returned Values 


I ..R&g. , 1 _ Pe££ x j.p£jLoil_ - _ 

I 

I A = console number 


Explanation 


The Get Console Number function returns a 
console number in register A. The console 
number is constructed by taking the network 
node number from the first entry of the cir¬ 
cuit assignment table (CKTAST), adding a 
constant (RCNOFF, default 0), and masking 
with another constant (RCNMSK, default OFFH). 
The resulting console number should be unique 
in most simple (one circuit) networks. 


NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 


foo % //»*e 


£ r 


fr 


os y 'f f S ^ v v ■ 
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Get Date and Time 
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C-Function 155 Get Date and Time 


Entry Arguments I Reg I __ De sc ription _I 

. i i 

l r - lSR I 

1 V/ — -l. +* ■ 

I DE = date/time packet address I 


Explanation The Get Date and Time function returns the 

system date and time in a five-byte date/time 
packet whose address is passed in DE. The 
date/time packet has the following structure: 


. 0: ffj5gt.j_Pfscjip£i-OH_- _ 

0-1 Date, represented as a 16-bit 
Julian date with 0000H corre¬ 
sponding to 31 December 1977. 

2 Hours, represented as two binary 
coded decimal (BCD) digits 

3 Minutes, represented as two bi¬ 
nary coded decimal (BCD) digits 

4 Seconds, represented as two bi¬ 
nary coded decimal (BCD) digits 


This is a variation of C-function 105, with 
seconds returned in the packet rather than in 
a register. 


03'-/^s, *?A 




5 4U-J, f 

j —■ j i- ■ 

fj a p ,jf r r y / 
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Set List 
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C-Function 160 

Entry Arguments 


Explanation 


Set List 


£.e.g. -L._ __ - Description _ 

« 

C = 160 

E = list device number (C-15) 


The Set List function saves the list device 
number passed in register E for use by a 
subsequent Conditional Attach List (C-func- 
tion 161). 

NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system, generation. 
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C-Function 161 
Cond. Attach List 
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C-Function 161 Conditional Attach List 


Entry Arguments I, Reg I . .Descripti on _I 

I I 

i C = 161 i 


Returned Value 


Explanation 


I _Descxlptlm 

I 

I A = 0 


The Conditional Attach List function sets the 
current printer number or queue number to the 
device specified in a prior Set List (C-func- 
tion 160). The print mode (direct, spooled, 
console) and spool drive are not affected. 
See T-function 27 (Get/Set Print Mode). 


NOTE: This function is supported only if the 
optional module MPMSUP is included during 
TurboDOS system generation. 


o « 
\\r 


r . z. u 7 




r i* C k 

:>_ IV 
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T—FUNCTIONS 


This section describes the TurboDOS-unique 
functions ("T-functions") which supplement 
the C-functions described in the previous 
section. The T-functions are presented in 


n u iu e r i c a x 


order, 


• . • JL U « 1 1 4 w J~€ V ^ /\ 4- v O 

Willi <^cuLj-.my pcuaiucucL b; 


return values, and a detailed explanation for 
each. 


To invoke a T-function, a program executes a 
CALL to location 0050H in the Base Page with 
a function number in register C. Arguments 
are passed and values returned in registers, 
as described below for each T-function. 

If a T-function call is made with register C 
set to an unsupported function number, Turbo¬ 
DOS returns immediately with register A set 
to zero. 

T-function calls generally destroy registers 
A-B-C-D-E-H-L, but preserve X, Y, and the 
alternate register set. 
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T-Function 0 
Reset Operating Sys. 


Copyright 1984 by Software 2000, Inc. 
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T-Function 0 

Entry Arguments 



Explanation The Reset Operating System function unlocks 

all locked records, closes all open files, 
unlocks all locked drives, and terminates any 
network sessions involving the calling 
process. 

TurboDOS automatically performs this function 
at each program termination (warm-start), so 
it is almost never necessary for a program to 
call this function explicitly. 

Som e. * ^ C-? 
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T-Function 1 
Create Process 


Copyright 1984 by Software 2000, Inc. 
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T-Function 1 

Entry Arguments 


Create Process 


Liteg. 1 - Description 

i C « 1 

I DE = entrypoint address 
I HL = workspace address 


Returned Value 


Explanation 


I -Heg. .1 __Dsscx±ptloii„ 

I A = 0 if successful 
I -1 if insufficient memory 


I 

I 


The Create Process function creates a new 
process which starts execution at the entry- 
point address passed in register DE. The new 
process is assigned a TurboDOS work area 
whose address appears to the new process in 
index register X, and a 64-word stack area 
whose address appears in the stack pointer 
register. If the process requires a re- 


ork area (usually allocated dynamic¬ 
ally using T-function 3), its address should 
be passed in register HL and will appear to 
the new process in index register Y. 


If this function is called with register DE 
set to zero, it causes the calling process to 
terminate. 


NOTE: This function is not intended for use 
by transient programs, and must be used with 
great care, bs v&e, ^/-os ei oJiof 

'jDV q (Uuj. . 
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T-Function 2 
Delay Process 
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Delay Process 


Heg, .1___Descri ption 

C = 2 

DE = tick count 


Explanation The Delay Process function causes the calling 

process to be suspended for the period of 
time specified by the tick count passed in 
register DF. A system "tick" is an implemen¬ 
tation-dependent time interval, usually 1/50 
or 1/60 of a second. The actual delay may 
vary from the requested tick count by plus or 
minus one tick. 

If the specified tick count is zero, then the 
calling program is suspended only long enough 
to allow any other ready processes to run (a 
so-called "courtesy" dispatch). 


T-Function 2 

Entry Arguments 
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T-Function 3 
Allocate Memory 
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T-Function 3 Allocate Memory 


Entry Arguments 



I DE = byte-length of requested segment I 


Returned Values I. Reg. I __ Descri ptio n___ 

i 

I A = 0 if successful 
I -1 if insufficient memory 

i HL = segment address (if successful) 


Explanation The Allocate Memory function allocates a 

contiguous memory segment of the byte-length 
requested in register PE. If successful, the 
starting address of the allocated segment is 
returned in register HL. 

NOTE: This function is not intended for use 
by transient programs, and must be used with 
great care. If a memory segment is allocated 
by a transient program and not deallocated 
before the program terminates, then the space 
is lost permanently. 
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T-Function 4 
Deallocate Memory 
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T-Function 4 


Deallocate Memory 


Entry Arguments 


Reg 1 _Dg&srjpti.CUV 

C = 4 

DE = segment address 


Explanation The Deallocate Memory function returns a 

previously-allocated memory segment to the 
pool of available memory space. 

NOTE: This function is not intended for use 
by transient programs, and must be used with 
great care. The address passed in DE must be 
a segment starting address returned by a 
prior call to C-function 3 (Allocate Memory), 
otherwise a system crash may occur. 
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T-Function 5 
Send I/P Message 
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T-Function 5 

Entry Arguments 


Explanation 


Send Interprocess Message 


...Reg. 


i C =5 

I DE = message node address 
I HL = message address 
I_ 



The Send Interprocess Message function pro¬ 
vides a means to send messages from one pro¬ 
cess to another. Register DE specifies the 
address of a 10-byte message node which must 
be initialized as follows: 


MSGNOD: .WORD 0 

.WORD MSGNOD+2 
.WORD MSGNOD+2 
.WORD MSGNOD+4 
.WORD MSGNOD+4 


semaphore count 
semaphore head 

H H 

msg chain head 

n n H 


Register HL specifies the 

m p o cj a n p f a ho e t.7 Vi i r« m n 

C uv k/C uc 11 u f Tt u x o u in u 

a 4-byte linkage as follows: 


address of the 

S +- K o rNrofi Ktt 

U ^J. t JL 1 ACU LJ £ 


MESSAG: .WORD 0 
.WORD 0 
•BYTE . 
.BYTE . 


message linkage 

IT II 

message text 
(any length) 


NOTE: This function is not intended for use 
by transient programs, and must be used with 
great care. 
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T-Function 6 
Receive I/P Message 
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T-Function 6 


Receive Interprocess Message 


Entry Arguments 


L Reg-1. 


I C = 6 I 

I DE = message node address I 


Returned Value 1 Reg I _ Des cr iption_ _I 

I I 

I HL = message address I 


Explanation The Receive Interprocess Message function 

provides a means to receive messages sent by 
another process using C-function 5 (Send 
Interprocess Message). Register DE specifies 
the address of a 10-byte message node which 
must be initialized as follows: 


MSGNOD: .WORD 0 ?semaphore count 

.WORD MSGNOD+2 ;semaphore head 
.WORD MSGNOD+2 ; 

.WORD MSGNOD+4 ;msg chain head 
.WORD MSGNOD+4 ; " " " 


If no message is available from the specified 
message node, the calling process is suspen¬ 
ded until a message arrives. This function 
returns in HL the address of the received 
message prefixed by a 4-byte linkage. 

NOTE: This function is not intended for use 
by transient programs, and must be used with 
great care. 
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T-Function 7 
Set Error Address 
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T-Function 7 Set Error Address 


Entry Arguments I Reg 1 ___jipjtjLPJl 


! DE = error intercept routine address, or I 
I 0 to restore default error handling I 


Explanation 


The Set Error Address function enables a 
program to establish its own error intercept 
routine to intercept and process unrecover¬ 
able disk errors. The address of the inter¬ 
cept routine is passed in register DE. 
Normal TurboDOS error diagnosis is supressed. 

The error intercept routine must not call any 
TurboDOS functions, and must return via a RET 
instruction with register A set to the de¬ 
sired error recovery alternative: 


A-reg I_„ Recovery Acti on 

0 retry operation 

+1 ignore error 

-1 abort program 


If the Set Error Address function is called 
with register DE set to zero, normal TurboDOS 
error diagnosis is restored. This also hap¬ 
pens automatically when the program termi¬ 
nates. 


"Do ^ f f A r i- * c <- ^ q > i h s-i r ~a ik 

<>rror- iH°v rtfjM 04 ^ 

(J5u|VU.> wSr (1 ^ 


iA ^ r r o^ 1 
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T-Function 8 
Set Abort Address 
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T-Function 8 

Entry Arguments 


Explanation 


Set Abort Address 


.R.e.g. J ___ Description _:_ 

C * 8 

DE = abort intercept routine address, or 
0 to restore default abort handling 


The Set Abort Address function enables a 
program to establish its own abort intercept 
routine to intercept and process user-reques¬ 
ted aborts (in response to attention-requests 
or disk errors). The address of the inter¬ 
cept routine is passed in register DE. 

The abort intercept routine may exit via a 
RET instruction to resume execution of the 
program at the point of interruption. Alter¬ 
natively, it may proceed with any desired 
wrap-up processing and then terminate the 
program. 


Jf the Set Abort Address function is called 
with register DE set to zero, normal TurboDOS 
abort handling restored. This also happens 
automatically when the program terminates. 
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T-Function 9 
Set Date and Time 
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T-Function 9 
Entry Arguments 


Set Date and Time 



i C = 9 

1 HL * Julian date (0 is 31 December 1947) 

I D = hours (0-23, binary integer) 

I E = minutes (0-59, binary integer) 


B = seconds (0-59, binary integer) 


Explanation The Set Date and Time function sets the sys¬ 

tem date and time. The Julian date passed in 
register HL is the number of days since the 
base date of 31 December 1947. Dates prior 
to the base date are represented by negative 
values. 

The system date and time may also be set by 
means of C-function 104 (Set Date and Time), 
but the format of arguments is considerably 
different. 

{hr ^ 
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T-Function 10 
Get Date and Time 
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T-Function 10 Get Date and Time 

Entry Arguments I_Bsg_L ~ ~ ~ ~ Description ~ ~ I 

I I 

I C = 10 I 


Returned Values 


Explanation 


The system tick count returned in register C 
is incremented every system tick. It counts 
from zero to 255, then wraps around to zero. 
A system tick is an implementation-dependent 
time interval, usually 1/50 or 1/60 of a 
second. 

The system date and time may also be interro¬ 
gated by means of C-functions 105 and 155, 
but the format of returned values is con¬ 
siderably different. 


I. Reg I ____ £Le.s.c.r.iptioi}_ 

I 

I HL = Julian date (0 is 31 December 1947) 

I D = hours <0-23, binary integer) 

I E = minutes (0-59, binary integer) 

I B = seconds (0-59, binary integer) 

I C = system tick count 


The Get Date and Time function returns the 
system date and time. The Julian date re¬ 
turned in register HL is the number of days 
since the base date of 31 December 1947. 
Dates prior to the base date are represented 
by negative values. 
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T-Function 11 
Rebuild Disk Map 
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T-Function 11 

Entry Arguments 


Rebuild Disk Map 


I Reg 1 „_Description 

I 

I r-% 11 

I K, = JLJ. 

I E = disk drive: 

! 0 for drive A 

I 1 for drive B 

I : 

I 15 for drive P 


Returned Value 


Explanation 


! _Beg„L __Description_ 

I A = 0 if successful 
I -1 if disk write-protected 

I or has files open 


The Rebuild Disk Map function regenerates the 
allocation map on the disk drive specified in 
register E. The principal purpose of this 
function is to support the FIXMAP command. 

k//|l iscL , Wo* biSk. Wk 
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T-Function 12 
Return Serial Number 
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T-Function 12 


Return Serial Number 


Entry Arguments 


Lite.g-, .1_ Description 

I 

I C = 12 

I _ 


I 


Returned Values 


Explanation 


l-Jte.g. . 1 _ _ _ P£&cxiptlon_I 

I HL = TurboDOS origin number I 
I DE = TurboDOS unit number ! 
I B - 0 if ncn-privileged log-on I 
! 80H if privileged log-on I 
I C = 14H (TurboDOS version 1.4) I 


The Return Serial Number function returns the 
origin and unit numbers with which this par¬ 
ticular copy of TurboDOS was serialized, and 
may be used in application programs to help 
prevent unauthorized use. 


This function also returns the TurboDOS ver¬ 
sion number, and a flag which indicates 
whether or not the current log-on is privi¬ 
leged. 


t ItA &- r pn'AU . J J * r “ - k'* 
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T—FUNCTIONS 

T-Function 13 
Set Compatibility 


ight 1984 by Software 2000, Inc. 
All rights reserved. 


Set Compatibility Flags 


I Reg 1_ Descri ption_ 

i C = 13 

I E = compatibility flags: 

I bit 7 = permissive flag 

I bit 6 = suspend flag 

I bit 5 = global-write flag 

I bit 4 = mixed-mode flag 

! bit 3 = logical flag 

I (bits 2-0 not defined) 


The Set Compatibility Flags function enables 
a program to modify the rules by which file 
sharing is done. The meaning of each compa¬ 
tibility flag is described in section 2. 

When the program terminates, the compatibili¬ 
ty flags revert automatically to the default 
values assigned to the public symbol COMPAT 
at system generation. 
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Log-On/Log-Off 
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T-Function 14 

Entry Arguments 


Returned Value 


Explanation 


Log-On/Log-Off 


Reg 


C 

DE 

E 


= 14 


D = 


OFFFFH (if log-off) 
user number 0-31 (if log-on) 
with bit 7 set for privileged 
current disk drive (if log-on) 
-1 for no change 
0 for drive A 
1 for drive B 


15 for drive P 


R^g. 

A 


0 if successful 
-1 if request invalid 


The Log-On/Log-Off function is provided to 
support log-on security via the LOGON and 
LOGOFF commands. To log-on, this function is 
called with the desired user number in regis¬ 
ter E (with bit 7 set if a privileged log-on 
is desired), and with the desired current 
drive in register D (or -1 for no change in 
current drive). To log-off, the function is 
called with both DE set to OFFFFH. 

After a log-off, another log-on request is 
not honored until a warn-start or C-function 
0 (System Reset) has occurred. 

NOTE: When this function is called from a 
resident system process, the D-register argu¬ 
ment is ignored. 

I ■ * ft f", ,• »./ <* 

Qrct A a A , \Q h * '' • ’ ? 

\ 9 J ■'$; <-■ v | , 
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T-Function 15 
Load File 
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T-Function 15 


Load File 


Entry Arguments 


Reg 


n —ic 


I DE = FCB address 


I 


I 


Returned Value I.J3.eg_i___ Description I 

i * “| 
I A = 0 if successful | 
i 1 if not enough memory to load file I 
I -1 if file not found I 


Explanation The Load File function loads the file speci¬ 

fied by the FCB drive, name, and type fields 
(bytes 0 through 11) into memory starting at 
the current DMA address. The file need not 
have been opened. If the top of the TPA is 
reached before the end-of-file is encoun¬ 
tered, the loading stops and an error is 
returned. 


If the specified drive is local to the pro¬ 
cessor in which tie call is made and the TPA 
is non-banked, the program load optimizer is 
used. if the drive is not local or the TPA 
is banked, multi-sector operations are used 
to optimize performance. 

This function is used by the TurboDOS command 
interpreter to load .COM files into the TPA, 
and may also be used by application programs 
to fetch overlays. 

TXaO pot . 

!<7 p_-*x\U$r W lofr*- 

W ^ ^ WO,*, 
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T-Function 16 
Activate Do-File 
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T-Function 16 

Entry Arguments 


Activate Do-File 



. —- 


I C =16 

I DE = FCB address (to activate) 
I 0 (to cancel) 


Returned Value 


Explanation 



I A = 0 if successful 
I -1 if file not found 


The Activate Do-File function causes the file 
specified by the FCB drive, name, and type 
fields (bytes 0 through 11) to be activated 
as a do-file. The file need not have been 
opened. Any currently-active do-file and/or 
command line is stacked (to be reactivated 
when the new do-file has been processed to 
completion). The principal purpose of this 
function is to support the DO command. 

This function may also be called with DE set 
to zero to cancel all active and stacked do- 


files. 

fb t •b 

CrCO ft, 7 ifi ji , 

[ y ’K ^k- i* 

f* 


jpo p 

fi : \ 1^ obo 

-jb •jvh"! 

r 

jK i ^ b-’t. 
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T-Function 17 
Dis/Enable Autoload 
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T-Function 17 

Entry Arguments 


Explanation 


Disable/Enable Autoload 


J„__ ___ J3fiscjj.pjtj.pn_l 

l 

C =17 i 

E = 0 to disable autoload I 

-1 to enable autoload I 


The Disable/Enable Autoload function may be 
used to disable the warm-start autoload fea¬ 
ture of TurboDOS, or to re-enable the feature 
after it has been disabled 

TurboDOS automatically disables the warm- 
start autoload feature whenever it fails to 
find the file WARMSTRT. AUT on the current 
disk during a warm-start. Creating such a 
file on disk (or changing the current disk to 
one that contains such a file) will not 
result in autoloading unless the autoload 
feature is explicitly re-enabled by means of 
this function. 


5-19 








TurboDOS 1.4 Z80 
Programmer's Guide 


T-FUNCTIONS 


T-Function 18 
Send Command Line 
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T-Function 18 

Entry Arguments 


Send Command Line 


.Reg_1___ „. D escription, 

C = 18 

DE = buffer address (to send) 
0 (to cancel) 


Explanation The Send Command Line function allows a pro¬ 

gram to specify the next command line to be 
processed by TurboDOS after the program ter¬ 
minates. The buffer address ispassed in 
register DE. The first byte of the buffer 
must contain the command line byte-length, 
and the command line text must occupy the 
second and succeeding bytes of the buffer. 
Any currently-active command line is stacked, 
and the new command line is activated. 

The commands are echoed to the console, un¬ 
less the command line starts with a leading 
command separator (backslant) character. 

This function may also be called with DE set 
to zero to cancel all active and stacked 
command lines. 

S/hllo* \o i po’Mts F</l ■H’V CP/W - l 

CH ft IV TO C oW».i 
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T-Function 19 
Return Alloc Info 
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T-Function 19 

Entry Arguments 


Feturned Values 


Explanation 


Return Disk Allocation Information 

B£ClL __ 



_D escripti on.- . , „ 


c = ±y 

E = disk drive: 

0 for drive A 
1 for drive B 

15 for drive P 


R e g 


_DeiLCjipti^iL 



A = block size: 

3 for IK blocks 

4 for 2K blocks 


7 for 16K blocks 
plus: bit 7 set if fixed disk 

bit 6 set if EXM=0 forced 
number of blocks in the directory 
number of blocks presently unused 


[t_. = total number of blocks on the disk 


The Return Disk Allocation Information func¬ 
tion returns various parameters concerning 
the logical organization of the specified 
disk drive. 

[pgb b( l{\Jl Coring' 
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T-Function 20 
Return Physical Info 
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T-Function 20 Return Physical Disk Information 


Entry Arguments 

LBgg—L 

i 

_ j£Scjip_tj._on _ 




1 c = 

20 




1 E = 

disk drive: 




1 

0 for drive A 




1 

1 

1 for drive B 




1 

1 

1 

15 for drive P 








Returned Values 

L Reg 1 

_Description 




A = physical sector size: 

0 for 128-byte sectors 

1 for 256-byte sectors 

2 for 512-byte sectors 

3 for IK sectors 

7 for 16K sectors 

BC = number of reserved (boot) tracks 
DE = total number of tracks on the disk 
HL = number of sectors per track 


Explanation The Return Physical Disk Information function 

returns various parameters concerning the 
format and physical organization of the 
specified disk drive. 

W iil «.f —I if -error', 
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T-Function 21 
Get/Set Drive Status 
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T-Function 21 


Get/Set Drive Status 


Entry Arguments 


I .1. . __Description_ 

i C = 21 
I E = disk drive: 

I 0 for drive A 

I 1 for drive B 

I 15 for drive P 

I D = 0 to set the drive read/write 
I 1 to set the drive read-only 

I -1 to return the drive status 


Returned Values 



A = 0 if successful 

-1 if attempt to set drive status 
while files are open 
L = 0 if drive is not ready 
-1 if drive is ready 
H = 0 if drive is read/write 
-1 if drive is read-only 


Explanation The Get/Set Drive Status function may be used 

to interrogate the ready and write-protect 
status of the drive specified by register E. 
This function may also be used to change the 
write-protect status of the drive. The code 
passed in register D controls which of these 
operations is performed, as indicated above. 

// oT £- W I 1*^"' a S-kta far i 
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Physical Disk Access 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


T-Function 22 Physical Disk Access 


Entry Arguments 1 Reg 1_Dg££li.p.tl m 

I 

I C = 22 

I DE = PDR packet address 


Returned Value I Reg I .Desc ri ption_ 

I 

I A = 0 if read/write successful, or 
I drive not ready 

I -1 if read/write unsuccessful, or 

I drive is ready 


Explanation The Physical Disk Access function provides 

direct access to the physical disk drivers. 
The principal purpose of this function is to 
support the BOOT, BACKUP, FORMAT, and VERIFY 
commands. It is honored for privileged log¬ 
ons only, and may be used only for local disk 
drives and non-banked TPA. 

Register DE contains the address of a 14-byte 
physical disk request (PDR) packet with the 
following structure: 


Offse t I .De^cjjLptjLpn_ 

0 disk operation code (0-4) 

1 disk drive (0-15) 

2-3 physical track number (base 0) 
4-5 physical sector number (base 0) 
6-7 number of sectors to read/write 
8-9 number of bytes to read/write 

10-11 DMA address for read/write 

12-13 disk specification table address 


The physical operation performed depends upon 
the disk operation coc?e in the PDR packet. 
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T-Function 22 
Physical Disk Access 
(Continued) 
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If the PDR opcode is 0, the specified number 
of physical sectors (or bytes) are read from 
the specified drive, track, and sector into 
the specified DMA address. 

If the PDR opcode is 1, the specified number 
of physical sectors (or bytes) are written to 
the specified drive, track, and sector from 
the specified DMA address. 

If the PDR opcode is 2, the type of the 
specified disk is determined, and an 11-byte 
disk specification table (DST) is returned at 
the specified DMA address, structured as 
follows: 


I Offse t I____Description___I 

I I 

I 0 block size (3=1K,4=2K,...,7-16K) I 

I 1-2 total number of blocks on disk I 

I 3 number of directory blocks I 

I 4 sector size (0=128,...,7=16K) I 

1 5-6 number of sectors per trac,k < I 

I 7-8 number offtrack* on the^xlisk 4. 

! 9-1Q number of reserved dESBtjt tracks ! ** 

|._.oktod d/HUC. !&?■t r oll')') _| 

If the PDR opcode is 3, the ready status of 
the specified drive is returned in register A 
(0 if not ready, -1 if ready). 

If the PDR opcode is 4, the specified track 
of the specified drive is formatted, using 
hardware-dependent formatting information 
provided at the specified DMA address. 

NOTE: Opcodes 0 (read) and 1 (write) require 

that the PDR packet contain the address of a 
valid DST for the specified disk. Therefore, 
opcode 2 (return DST) should be invoked first 
to obtain the DST. 


S'E 5 /JOT&S 
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T-Function 23 


Set Buffer Parameters 


Entry Arguments 


Reg 1 __. _ . . PegSJigtion_ 

C = 23 

D = number of buffers (minimum 2) 
E = buffer size: 

0 for 128-byte buffers 

1 for 256-byte buffers 

2 for 512-byte buffers 

3 for IK buffers 

7 for 16K buffers 


Explanation 


The Set Buffer Parameters function enables 
the number and size of disk buffers to be 
changed. The principal purpose of this func¬ 
tion is to support the BUFFERS command. 

The specified number of buffers must be at 
least 2. If the specified number of buffers 
cannot be allocated due to insufficient 
memory, then TurboDOS allocates as many as it 
can. The specified buffer size must be as 
least as large as the largest physical disk 
sector size being used. 


If this function is called 
cessor without local disk 
function is passed over 
processed in the master. 


~ C 


h v t v'i' 



from a slave pro¬ 
storage, then the 
the network to be 


V 
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T-Function 24 
Get Buffer Parameter 
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T-Function 24 
Entry Arguments 


Get Buffer Parameters 




Explanation The Get Buffer Parameters function enables 

the number and size of disk buffers to be 
interrogated. The principal purpose of this 
function is to support the BUFFERS command. 

If this function is called from a slave pro¬ 
cessor without local disk storage, then the 
function is passed over the network to be 
processed in the raster. 
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T-Function 25 
Lock/Unlock Drive 
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T-Function 25 


Lock/Unlock Drive 


Entry Arguments 


C = 25 

E = disk drive: 

0 for drive A 
1 for drive B 

15 for drive P 
D = 0 to unlock drive 
-1 to lock drive 


Returned Value 


_ Ess- J___scxipbim __- -. 

A =0 if successful 

-1 if drive in-use or already 

locked by another process 


Explanation 


The Lock/Unlock Drive function enables a 
program to secure a lock on a specified disk 
drive. This function is used by rrany Turbo¬ 
DOS commands such as BACKUP, CHANGE, FIXDIR 
FIXMAP, FORMAT, and VERIFY to ensure tha 
they cannot compromise the processing of 
other users. 
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T-Function 26 
Flush/Free Buffers 
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T-Function 26 


Flush/Free Buffers 


Entry Arguments 


I ..1____ Pe££jip:tioii_I 

i C = 26 i 

i E = disk drive: I 

I 0 for drive A I 

I 1 for drive B 1 

I • 1 

1 • ! 

I 15 for drive P I 

I D = subfunction flags: I 

! bit 7 set to free buffers uncon- I 

I ditionally I 

I bit 6 set to free buffers after I 

I disk error abort I 

I bit 5 set to continue after disk I 

I error abort I 

I bit 4 set to return after disk I 

I error abort I 


Explanation 


The Flush/Free Buffers function causes all 
written-to disk buffers for the specified 
disk drive to be written out (flushed) to the 
disk. This function may cause disk buffers 
for the specified drive to be freed, condi¬ 
tionally or unconditionally, according to the 
subfunction flags passed in register D. 


It is suggested that this function be used 
prior to media changes and physical disk 
access (T-function 22). 
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Get/Set Print Mode 
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T-Function 27 Get/Set Print Mode 


Entry Arguments 

1 

Req 

J_ P££cjip_t±©n_ 

1 

1 

C 

= 27 


1 

E 

= print mode: 


1 


0 to print direct 


1 


1 to print spooled 


1 


2 to print to the console 


1 


-1 to leave print mode unchanged 


1 

D 

= printer assignment (if mode = 0) 


1 


queue assignment (if mode = 1) 


1 


-1 to leave assignment unchanged 


1 

B 

= spool drive: 


1 


0 for drive A 


I 

i 


1 for drive B 


i 

1 


15 for drive P 


1 


-1 to leave spool drive unchanged 


Returned Values 


Reg _L___PespjriptiPR- „-- 

If B = D = E = -1 on entry, returns with: 
A = current spool drive 
H = current printer or queue assignment 
L = current print mode 


Explanation 


The Get/Set Print Mode function is used to 
set or interrogate print routing, and is 
provided to support the PRINT command. 


Printer and queue assignments are coded thus: 
1 for A, 2 for B, ..., 16 for P. Assignment 
to queue zero causes print files to be left 
unqueued. Assignment to printer zero causes 
print output to be discarded. Setting the 
assignment, mode, or spool drive implies an 
immediate end-of-print-job condition. If 
registers B, D, and E are all set to -1, this 
function simply interrogates and returns the 
current assignment, mode, and drive. , , 


l-F 
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T-Function 28 
Signal End-of-Print 
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T-Function 28 


Signal End-of-Print 


Entry Arguments 


I Reg 1 



^ n 


= 


Description. 


Explanation The Signal End-of-Print function causes an 

end-of-print condition. If spooling is in 
effect, the current print file is closed and 
(if appropriate) enqueued for background 
printing. 

An end-of-print condition may also occur as 
the result of a war m-star t, attention re¬ 
quest, or end-of-print character. 
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T-Function 29 

Entry Arguments 


Get/Set De-Spool Mode 



C = 29 
B = printer: 

0 for printer A 
1 for printer B 

15 for printer P 
E = de-spool mode: 

0 to process print job 

1 to suspend print job 

2 to begin print job over 

3 to terminate print job 
-1 to leave mode unchanged 

D = de-spool queue assignment: 

0 to set printer off-line 

1 for queue A 

2 for queue B 

16 for queue P 

-1 to leave queue unchanged 


Returned Values 



A = 0 if successful 

-1 if invalid request 


If D = E = -1 on entry, returns with: 
H = current queue assignment (0-16) 
L = current de-spool mode (0 or 1) 


Explanation The Get/Set De-Spool Mode function is used to 

control background printing, and is provided 
to support the IPRINTER command. If registers 
D and E are both set to -1, this function 
simply interrogates and returns the current 
queue assignment and de-spool mode for the 
specified printer. 
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Queue a Print File 
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T-Function 30 


Queue a Print File 


Entry Arguments 1 Reg I _ Descri ption_ 


I DE = FCB address I 
I H = print queue: I 
I 0 for queue A ! 
I 1 for queue B I 

I 15 for queue P I 
I L = user number (0-31), plus I 
i bit 7 set to delete after printing I 


Returned Value I Reg I . _. „ _ „ _cxiption. 

I 

I A = 0 if successful 
I -1 if invalid request 

Explanation The Queue a Print File function enqueues a 

text file on a specified print queue for 
background printing. The file to be enqueued 
is identified by the FCB drive, name and type 
fields (bytes 0 through 11), together with 
the user number passed in register L. 

The drive specified by the FCB must be acces¬ 
sible by the processor in which the specified 
queue resides, otherwise the request is 
invalid. To check this, the function may be 
called with register L set to -1, in which 
case the FCB drive and requested queue are 
checked for validity but no file is queued. 
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T-Function 31 
Flush List Buffer 
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T-Function 31 

Entry Arguments 


Explanation 


Flush List Buffer 


Reg I 


■D££ Cj ;j.p, t i.on 


I C = 31 
I 


The Flush List Buffer function is used by 
TurboDOS during direct printing over the 
network to force any remaining buffered char¬ 
acters to be printed. There should be no 
need for an application program to call this 
function. 


b 


O M 




£> r 
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T-Function 32 
Network List Out 
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T-Function 32 Network List Out 

Entry Arguments 1 Reg .1_D££cxi.ptiPH 


i C =32 

I E = output character 


Explanation The Network List Out function is used by 

TurboDOS during direct printing over the 
network. There should be no need for an 
application program to call this function. 
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T-Function 33 


Remote Console I/O 


Entry Arguments 


I Reg I __ _ _DeSjcjiptlon___1 

I I 


I C = 33 I 
I E = console input character, or I 
I 0 if no console input available I 
I D = 0 to detach remote console I 
I -1 to attach remote console I 


Returned Value 


Explanation 


I Reg 1 _,_^_D££4^xpJ;iPIL_* . . _ 

I A = 0 if CONREM not present 
I 1 if successful 

I -1 if executing in master 


The Remote Console I/O function works in 
conjunction with the CONREM console driver to 
support the MASTER command. It passes one 
byte of console input in register E (if 
available), and returns a count byte and up 
to 127 bytes of console output at the current 
DMA address. There should be no need for an 
application program to call this function. 


w 1 '" 'f 
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T-Function 34 
Get Comm Status 
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T-*Function 34 

Entry Arguments 


Get Comm Channel Status 

I Reg . 1_I_ Descriptio n___ 

I 

I n — o a 

I v* — J •* 

I D = channel number, plus 

I bit 7 set if remote channel 


Returned Value 


Explanation 


l_ Reg„i___ ___Description_i 

I I 

I A = 0 if input character not available I 
I -1 if input character is available I 

|...______ __ I 


The Get Comm Channel Status function checks 
to see whether or not an input character is 
available on the specified comm channel. If 
a character is available, it returns A = -1. 
Otherwise, it returns A = 0. 


TV : cont-wl i Aet \^o r -U, 
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T-Function 35 
Comm Channel Input 
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T-Function 35 


Comm Channel Input 


Entry Arguments I Reg 1 __DescxiptiOH-I 

I I 
I C = 35 I 
I D = channel number, plus I 
I bit 7 set if remote channel I 


Returned Value I Reg 1 _Descri ption. 

I 

J..... A = input character 


The Comm Channel Input function obtains the 
next input character from the specified comm 
channel, and returns in in register A. If no 
character is available, the calling program 
is suspended until a character is received. 


Explanation 
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T-Function 36 
Comm Channel Output 
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T-Function 36 Comm Channel Output 


Entry Arguments I Reg .1 ______ Description _ 

I 

l n _ 'l 

I — JO 

I D = channel number, plus 

I bit 7 set if remote channel 

I E = output character 


Explanation The Comm Channel Output function outputs the 

character passed in register E on the speci¬ 
fied comm channel. 
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T-Function 37 
Set Comm Baud Rate 
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T-Function 37 


Set Comm Baud Rate 


Entry Arguments 


Bag. 


JDeacxiptiPn„ 


C 

D 



r(A{S 

aA ^ V ' 


Explanation 


Wi !l i *-( 1L *!h 

(V ^ ||0^O 


= 37 

= channel number, plus 

bit 7 set if remote channel 
-baud rate code (bits 3-0): 

0 for 50 baud 8 for 1800 baud 

1 for 75 baud 9 for 2000 baud 

for 110 baud 10 for 2400 baud 

for 134.5 baud 11 for 3600 baud 

for 150 baud 12 for 4800 baud 

for 300 baud 13 for 7200 baud 

for 600 baud 14 for 9600 baud 

for 1200 baud 15 for 19200 baud 
plus bit 7 set for att'n detection 
bit 6 this channel is a CTS 
protocol channel 
bit 5 set for disable receive 
interrupt 

bit 4 this channel is an 

XON/XOFF protocol channel 


The Set Comm Baud Rate function sets the baud 
rate and options passed in register E on the 
specified comm channel. The protocol can be 
set to CTS, XON, or none. 




5“^ 


f 




/s Sc/'V {iM > f 





SO 

1“C febJt " r ,'-" *'!•*< \A * ( j 

no 

I US , m/oaU T p / 

iso. 6^4 - 

loo tt.Jk - 

6oo toJi - 

a oo 60 wd - 

ifoO ' -J V. 4 Z'sr*f< 

tv Oa0° ^ 0V, 1 

qf.1 O iS- • - 5-40 


'fyj * f! ? 








TurboDOS 1.4 Z80 
Programmer's Guide 


T-FUNCTIONS 


T-Function 38 
Get Comm Baud Rate 
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T-Function 38 Get Comm Baud Rate 


Entry Arguments 1 Reg I ___Descripti on 

! 

I C = 38 

I D = channel number, plus 
I bit 7 set if remote channel 


Returned Value 1 Reg 1 _ Description _I 

I I 

I A = baud rate code (bits 3-0): I 

I 0 for 50 baud 8 for 1800 baud I 

I 1 for 75 baud 9 for 2000 baud I 

I 2 for 110 baud 10 for 2400 baud I 

I 3 for 134.5 baud 11 for 3600 baud ! 

I 4 for 150 baud 12 for 4800 baud I 

I 5 for 300 baud 13 for 7200 baud I 

I 6 for 600 baud 14 for 9600 baud I 

I 7 for 1200 baud 15 for 19200 baud I 

I plus bit 7 set for att'n detection I 

I bit 6 this channel is a CTS I 

I protocol channel I 

1 bit 5 set for disable receive ! 

* I interrupt I 

i bit 4 this channel is an I 

I XON/XOFF protocol channel I 


Explanation The Set Comm Baud Rate function interrogates 

the baud rate and options for the specified 
comm channel, and returns this information in 
register A. The protocol can be set CTS, 
XQN, or none. 


5-41 






TurboDOS 1.4 Z80 
Programmer's Guide 


T-FUNCTIOHS 


T-Function 39 
Set Modem Controls 
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T-Function 39 


Set Modem Controls 


Entry Arguments 


I Reg .1__ 

I C = 39 

I D = channel number, plus 

I bit 7 set if remote channel 

I E = modem control vector: 

I bit 7 set for request-to-send 

I bit 6 set for data-terminal-ready 

I bit 5 set for 1=8 bits/char I 

I 0=7 bits/char 

I bit 4 set for 1 = even parity I 

I 0 = odd parity 

I bit 3 set for 1 parity enabled 

I bit 2 set for 1 handshaking 

I enabled 


Explanation The Set Modem Controls function sets the 

modem control signals in accordance with the 
vector passed in register F on the specified 
comm channel. 

t/suoi^ f©/' a hoi *0+ rLfjU&k 
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Entry Arguments 


Returned Value 


Explanation 


T-FUNCTIONS 

T-Function 40 
Get Hodem Status 


t rr Vs 4- 1 Q O 4 U n r 1 — A a A A — 

j-ynu ±bo*± uy Durtwdre zuuu, me. 
All rights reserved. 


chom i-tl 

Get -Modern Status 


-££.g 


I r - An 

• v — -*v/ 

I D = channel number, plus 

• bit 7 set if remote channel 


R - e< 3 i —-—-D-as^jripiioiL__ 

A = modem status vector: 

bit 7 set for clear-to-send 

bit 6 set for data-set-ready. 

SCC does not have. (Model 
1200 = CPU ports) 
bit 5 set for data-carrier-detect 

bit 4 set for ring-indicator. 

SCC does not have. (Model 
1200 = CPU ports) 
bits 3-0 unassigned 


-he SCt I' CCem S t a t U S function 1 ri f Cl r r rvn a r> e 

* v.- a. *• V. V r t u uco 

the modem status signals for the specified 
comm channel, and returns this information as 
a vector in register A. 


5-43 








TurboDOS 1.4 Z80 
Programmer's Guide 


T-FUNCTIONS 


T-Function 41 
User-Defined Fen 
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T-Function 41 

Entry Arguments 


Returned Values 


Explanation 


User-Defined Function 


Reg 1_ Description ___ 

C = 41 

B = network routing: 

0 if always processed locally 
Id hex if routed per drive d 
2p hex if routed per printer p 
3q hex if routed per queue q 
-1 if routed to default net addr 
-2 if routed to net addr in DE 
DE = user-defined argument passed, 
cr network address (if B=-2) 

HL - user-defined argument passed 


Reg 1___ Description___ 

A = user-defined value returned 
BC = user-defined value returned 
DE = user-defined value returned 
HL = user-defined value returned 


The User-Defined Function provides a means 
for adding user-defined extensions to the 
operating system taking full advantage of the 
TurboDOS networking facilities. On entry, 
register B defines ho \i the request is to be 
routed over the network. Registers DE and HL 
plus the 128-byte record at the current DMA 
address are all passed (over the network if 
necessary) to a user-defined module with the 
public entrypoint symbol USRFCN. Upon entry 
to the USRFCN routine, register BC contains 
the address of the 128-byte record that was 
passed. The USRFCF routine may return 
information to the caller in any of the seven 
registers A-B-C-D-E-H-L and in the 128-byte 
record. 
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T-Function 42 
Reorg Disk Directory 
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T-Function 42 Reorganize Disk Directory 


Entry Arguments 

1 

_R£S~ 1 

. . Description 



1 

j 

i 

i 

i 

i 

c = 

E = 

42 

disk drive: 

0 for drive A 

1 for drive B 

i 

i 


1 

i 


• 

15 for drive P 







Returned Value 

i 

Reg 1 

_ Description 



i 

i 

i 

i 

A = 

0 if successful 
-1 if disk write-protected 
or has files open 



Explanation The Reorganize Disk Directory function reorg¬ 

anizes the directory on the disk drive speci¬ 
fied in register E. If the hashed-directory 
flag bit in the volume label has been 
changed, this function will convert a hashed 
directory into linear format (or vice versa). 
The principal purpose of this function is to 
support the FIXDIR command. 

NOTE s In certain cases, this function may 
take a very long time to complete (possibly 
hours), and cannot be interrupted once in¬ 
voked. 

to ReseTV 

\jf Ho/' S ho us*, , £x/! 

"Vo i'veu/s, 
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T-Function 43 
Select Memory Bank 
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T-Function 43 Select Memory Bank 


Entry Arguments 


_Rgg. 


I C = 43 

! E = 0 to select bank 0 
I 1 to select bank 1 

I -1 to interrogate current bank 


I 


Returned Value 


l„Beg. .1 

I 


= current bank (0 or 1) 


Explanation The Select Memory Bank function selects the 

memory bank in which the TPA resides, accord¬ 
ing to the bank number (0 or 1) passed in 
register E. If E = -1, this function simply 
interrogates the current bank mode and 
returns the current bank number (0 or 1) in 
register A. This function is honored for 
privileged log-ons only, and is provided 
primarily to support the BANK command. 

A request to select bank 0 is ignored if 
there is not enough free memory in bank 0 for 
ci minimum-size TPA, as defined by the patch- 
able symbol MEMBLL. (More specifically, bank 
0 cannot be selected unless MEMBAS-MEMRES-3 
is greater than or equal to MEMBLL.) 

This function has no effect in a non-banked 
system, and always shows that bank 0 is 
selected. 
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MONITOR Command 


Syntax 


Explanation 


Directives 


The MONITOR command provides various facili¬ 
ties under Z80 TurboDOS useful to programmers 
who have the need to debug or patch programs 
and files. 


I MONITOR 
I_ 


The MONITOR command operates in an interac¬ 
tive mode. You are prompted by an asterisk * 
to enter a series of directives from the 
console. The Q directive (quit) terminates 
the MONITOR command. 

In the directive descriptions that follow, 
all addresses and other numeric arguments are 
in hexadecimal, and all file names ("fn") are 
entered as (d:}filename{.typ): 


D .ire .cjbj.ve, J___Exp lana tion__ 

C vl,v2 


D al,a2 


E a 


Calculates the sum and dif- 
erence of two hex values. 

Dumps the area of memory be¬ 
tween the two given addresses 
in hex. Pause with space, 
resume with RETURN. 

Examines memory starting at 
the given address. You may 
substitute a new hex value 
for each displayed byte of 
memory. Enter space or RE¬ 
TURN to go on to the next 
byte, or ESC to exit examine 
mode. 


A-l 
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Directives 

(Continued) 


. Pijec.tiv.e. __Eaplanati-QD_ 

F al,a2(,v{,r)) 

Fills the area of memory be¬ 
tween the two given addresses 
with the given value v (or 0 
if no value is given). If a 
repetition factor r is given, 
the operation is repeated r 
times (useful with some PROM 
programmers). 

G a Goes (jumps) to the instruc¬ 

tion at the given address. 

H Help menu is displayed, list¬ 

ing all MONITOR directives. 


I p Inputs a byte from I/O port p 

and displays its hex value. 

L fn {a> Loads the named file into 

memory starting at the given 
address (or 0100H if no ad¬ 
dress is given). 


M al,a2,a3(,r} 

Moves the block of memory 
between al and a2 into the 
area starting at a3. If a 
repetition factor r is given, 
the operation is repeated r 
times (useful with some PROM 
programmers). 

0 p,v Outputs the hex value v to 

I/O port p. 

P a Puts succeeding typed ASCII 

data into memory starting at 
the given address. Terminate 
by typing CTRL-D (ASCII EOT). 
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(Continued) 
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Q Quits the monitor command. 


i R ai r 6.2 RAM area between al and a2 is 
tested, and memory errors are 
diagnosed. Typing ESC aborts 
the test early. 

S fn {al,a2> 

Saves the area of memory be¬ 
tween the given addresses in 
the named file. If no memory 
addresses are given, then the 
bounds from the last L (load) 
directive are used. 

T al,a2 Types the area of memory be¬ 

tween the given addresses in 
ASCII. Pause with space, re¬ 
sume with RETURN. 

V al,a2,a3 Verifies that the block of 

memory from al to a2 is iden¬ 
tical to the area starting at 
a3. Any descrepancies are 
diagnosed. 

t 

W vl,...,vN Scans all of memory for oc¬ 
currences of the given byte 
string, and displays Where 
ea.eh occurrence is found. 

Y Displays the highest avail¬ 
able address in memory (below 
TurboDOS and the MONITOR com¬ 
mand code). 
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Examples 


0A> MONITOR 

TurboDOS Monitor -- Copyright etc. 

* X 

E7FF 

* C E7 FF 100 

E8FF E6FF 

* 

* D-LMjIIF 

0100 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 etc. 
0110 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 etc. 

* Q. 

0k) 
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C - .1 



Values Returned. 

0 

System Reset 

_ 



1 

Console Input 

~ 


A = char 

o 

Paw o a! /n Anf aii 4- 
u v/ j. c 

i? — 
u — 

aV\ r 

V11UL 

- 

3 

Raw Console Input 

- 


A = char 

4 

Raw Console Output 

E = 

char 

- 

5 

List Output 

E = 

char 

- 

6 

Direct Console I/O 

E = 

-1 (inp/sta) 

A = 0/char 



E = 

-2 (status) 

A = 0/-1 



E = 

-3 (input) 

A = char 



E = 

char (output) 

- 

7 

Get I/O Byte 

- 


A = I/O byte 

8 

Set I/O Byte 

E = 

I/O byte 

- 

9 

Print String 

DF. 

= ^string 

- 

10 

Read Console Buffer 

DE 

= &buffer 

- 

11 

Get Console Status 

- 


A = 0/-1 

12 

Return Version 

- 


EL = 0031E 





DE = net addr 

13 

Reset Disk System 

- 


- 

14 

Select Disk 

E = 

drive (0=A) 

- 

15 

Open File 

DE 

= &FCB 

A = (-1 if err) 

16 

Close File 

DE 

= &FCB 

A = (-1 if err) 

17 

Search for First 

DE 

= &FCB 

A = (-1 if err) 

18 

Search for Next 

- 


A = (-1 if err) 

19 

Delete File 

DF 

= &FCB 

A = (-1 if err) 

20 

Read Sequential 

DE 

= &FCB 

A = (NZ if err) 

21 

VIrite Sequential 

DF 

= &FCB 

A = (NZ if err) 

22 

Make File 

DE 

= &FCE 

A = (-1 if err) 

23 

Rename File 

DE 

= &FCB 

A = (-1 if err) 

24 

Return Login Vector 

- 


HL = vector 

25 

Return Current Disk 

- 


A = drive (0=A) 

26 

Set DMA Address 

DE 

= &DMA 

- 

27 

Get ALV Address 

(not supported) 

HL = 0 

28 

Write Protect Disk 

- 


- 

29 

Get R/O Vector 

- 


HL = vector 

30 

Set File Attributes 

DE 

= &FCB 

A = (-1 if err) 

31 

Get DPB Address 

- 


HL = &DPB 

32 

Get/Set. User Number 

E = 

-1 

A = user number 



E = 

user number 

- 

33 

Read Random 

DF. 

= &FCB 

A = (NZ if err) 

34 

Write Random 

DE 

= &FCB 

A = (NZ if err) 
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„ CrFuncjtj-PiL Nam_e„ J 

Arauments Passed 1 

yali 

res. Returned 


1 

35 

Compute File Size 

DE = &FCB 

A = 

(-1 if err) 

1 

1 

1 

36 

Set Random Record 

DE = &FCB 

— 


1 

1 

37 

Reset Drive 

DE = vector 

- 


1 

1 

40 

Write Random 0-Fill 

DE = &FCB 

A = 

(NZ if err) 

1 

1 

42 

Lock Record 

DE = &FCB 

A = 

(NZ if err) 

1 

1 

43 

Unlock Record 

DE = &FCB 

A = 

(NZ if err) 

1 

I 

44 

Set Multi-Sector Ct 

E = record count 

A = 

0 

1 

1 

46 

Get Disk Free Space 

E = drive (0=A) 

A = 

0 

1 

1 

47 

Chain to Program 

(Cmd at 0080H) 

— 


1 

1 

104 

Set Date and Time 

DE = &DTP 

— 


1 

I 

105 

Get Date and Time 

DE = &DTP 

A = 

seconds/BCD 

1 


107 

Return Serial Nbr 

DE = &SN 

— 


i 

1 

108 

Get/Set Return Code 

DE = 0FFFFH 

KL = 

retcode 

i 

1 



DE = retcode 

— 


i 

1 

110 

Get/Set Delimiter 

DE = 0FFFFH 

A = 

delimiter 

i 

1 



E = delimiter 

- 


i 

1 

111 

Print Block 

DE = &CCB 

— 


i 

1 

112 

List Block 

DE = &CCB 

— 


i 

1 

134 

Make Queue 

DE = &QD 

A = 

(NZ if err) 

i 

1 

135 

Open Queue 

DE = &QPB 

A = 

(NZ if err) 

i 

1 

136 

Delete Queue 

DE = &QPB 

A = 

(NZ if err) 

i 

1 

137 

Read Queue 

DE = &QPB 

A = 

(NZ if err) 

i 

1 

138 

Cond'l Read Queue 

DE = &QPE 

A = 

(NZ if err) 

i 

1 

139 

Write Queue 

DE = SQPB 

A = 

(NZ if err) 

i 

1 

140 

Cond'l Write Queue 

DE = &QPB 

A = 

(NZ if err) 

i 

1 

141 

Delay 

DE = tick count 

— 


i 

1 

142 

Dispatch 

- 

_ 


i 

1 

143 

Terminate 

- 

— 


i 

1 

152 

Parse Filename 

DE = &PFCB 

HL = 

0 if EOL 

i 

1 





-1 if error 

i 

1 





else &delim 

i 

1 




DE = 

Seelim 

i 

1 

153 

Get Console Number 

- 

A = 

console no. 

i 

1 

155 

Get Date and Time 

DE = &DTP 

- 


i 

1 

160 

Set List 

E = list dev. no. 

- 


i 

1 

1 

161 

Cond'l Attach List 


A = 

0 

i 

i 
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0 Reset O/S 


1 

Create Process 

DE 

TJT 

= 

Sentrypoint 

ocwujl Mspa^c 

tick count 

A = 

0/-1 

1 

i 

2 

Delay Process 

iijj 

DE 

s 

— 


i 

3 

Allocate Memory 

DE 

= 

length 

A = 

0/-1 







HL = 

&memory 


4 

Deallocate Memory 

DE 

= 

Smemory 

- 



5 

Send I/P Message 

DE 

= 

Smsgnode 

- 





HL 

= 

^message 



j 

6 

Receive I/P Message 

DE 

= 

Smsgncde 

HL = 

^message 


7 

Set Error Address 

DE 

= 

0/&errorcode 

- 



8 

Set Abort Address 

DE 

= 

0/&abortcode 

- 



9 

Set Date and Time 

HL 

= 

Julian date 

- 




D = hours 
E = minutes 
E = seconds 


10 Get Date and Time - HL = Julian Date 

D = hours 
E = minutes 
B = seconds 
A = tick count 

11 Rebuild Disk Map E = drive (A=0) A = 0/--1 

12 Return Serial Nbr - HL = origin # 


DE = unit # 

B = 80H if priv 
C = 14H version 


13 

Set Compatability 

E = 

compatflags 

- 

14 

Loc-Cn/Log-Off 

DE 

= OFFFFH (off) 

A = 0/-1 



D = 

-1/drive (on) 




E = 

user nbr (on) 


15 

Load File 

DE 

= &FCB 

A = 0/1/-1 

16 

Activate Do-File 

DF 

= 0/&FCB 

A = 0/-1 

17 

Dis/Enable Autoload 

E = 

0 (disable) 

- 



E = 

1 (enable) 


18 

Send Command Line 

DE 

= 0/&buffer 

— 

19 

Get Alloc Info 

E = 

drive (0=A) 

A = block size 


C = dir blocks 
DE = free block 
HL = tot. block 


C-l 
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. -C_ =. J_ _L Arguments. Passed I Values Ret urned 


20 

Get Physical Info 

E 

= 

drive (0=A) 

A 

= 

sector size 






BC ‘ 

= res. tracks 






DE ; 

= tot. tracks 






HL 

1 ! 

= sectors/trk 

21 

Get/Set Drv Status 

E 

= 

drive (0=A) 

A 

ss 

0/-1 



D 

= 

0 (set R/W) 






D 

= 

1 (set R/O) 






D 

= 

-1 (get) 

L 

= 

-1 if ready 






H 

= 

-1 if R/O 

22 

Phys. Disk Access 

DE * 

= &PDR 

A 

= 

0/-1 

23 

Set Buffer Params 

D 

=: 

# of buffers 

- 





E 

w 

buffer size 




24 

Get Buffer Params 

- 



A 

s 

mem. size 






H 

— 

# of buffers 






L 

= 

buffer size 

25 

Lock/Unlock Drive 

E 

= 

drive (0=A) 

A 

= 

0/-1 



D 

= 

0 (unlock) 






D 

s= 

-1 (lock) 




26 

Flush/Free Buffers 

E 

= 

drive (0=A) 

- 





D 

= 

subfunctions 




27 

Get/Set Print Mode 

E 

= 

print mode 

A 

= 

spool drive 



D 

= 

printer/queue 

H 

= 

prntr/queue 



F 

= 

S£Ool drive 

L 

= 

print mode 

28 

Signal End-of-Print 

- 



- 



29 

Get/Set Despool Mod 

E 

= 

despool mode 

A 

= 

C/-1 



D 

= 

queue assgnmt 






B 

= 

printer 




30 

Queue a Print File 

DE 

1 „ 

1 ” 

= &FCB 

A 

= 

0/-1 



H 

= 

print queue 






L 

— 

user#/delete 




31 

Flush List Buffer 

- 



- 



J 1 

Metwcrk List Cut 

F. 

= 

char 

- 



33 

Remote Console I/O 

E 

= 

0/char 

A 

= 

0/1/-]. 



D 

= 

-1 to attach 




34 

Get Comm. Status 

D 

ss 

channel/rmt 

A 

= 

0/-1 

35 

Comm Channel Input 

D 

= 

channel/rmt 

A 

= 

char 

36 

Comm Channel Output 

D 

= 

channel/rmt 

- 





E 


char 
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._Aj 

igi 

intents. Passed^ J 

Values Returned 

37 

Set Comm Baud Rate 

D 


channel/rmt 




E 

= 

baudrate 


38 

Get Comm Baud Rate 

n 

= 

r* a r. n c* 1 / rmf 

v/ A J- kA 1 x _L_ / i. ill ^ 

h — K^nrlrof a 

4T3 - UUUUl u UC 

39 

Set Modem Controls 

D 

= 

channel/rmt 




E 

= 

vector 


40 

Get Modem Status 

D 

= 

channel/rmt 

A = vector 

41 

User-Defined Fen 

B 

= 

net routing 

ABCDEHL userdef 



DEHL userdef 


42 

Reorg Disk Dir 

E 

= 

drive (0=A) 

A = 0/-1 

43 

Select Memory Bank 

E 

- 

-1 (interrog) 

A = bank # 



E 

= 

0 (bank 0) 




E 


1 (bank 1) 
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Access Manager Digital Research's Access Manager package 

runs under TurboDOS versions 1.40 and later. 
The modules MPMSUP and QUEMGR must be inclu¬ 
ded in the system generation. In addition, 
certain special procedures must be followed. 

The 8080 Access Manager background server is 
distributed in page-relocatable form as the 
file AM80.PRL. TurboDOS requires that it 
must be converted to an executable .COM file. 
We have included a utility PRLTOCOM.COM that 
converts programs from .PRL to .COM format. 
To create AM80.COM from AM80.PRL, do this: 


0A}PRLTOCO M AM80 
Conversion complete. 
0A> 


Several queues must be created before AM80 is 
run: a common queue AM80 and some number of 
user queues AM8USR1 through AM8USRn. We have 
included another utility AM80INIT.COM for 
this purpose. To start up Access Manager for 
a five-user configuration*", do this: 


0 A) AM-80.IN IT 5 
Queues created. 
0A1 AM80 


One problem is that AM80 does not provide any 
means of terminating itself. Since AM80 
keeps queues open, it interferes with the use 
of the BUFFERS and CHANGE commands. One 
solution is to run AM80 in a slave, and to 
intentionally reset (crash) the slave when 
AM80 is no longer wanted. Even then, it may 
be necessary to manually delete the FIFOs if 
they were non-empty when AM80 was terminated. 
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Access Manager The QUEMGR module of TurboDOS contains a 
(Continued) patchable symbol QUEDLY that determines the 

delay interval (in "ticks") between sampling 
of queues when they have become empty or 
full. QUEDLY defaults to zero (no delay). 
If an PTC driver is available, QUEDLY should 
be patched to the largest value that provides 
satisfactory performance. This will reduce 
dispatch overhead and network traffic load. 


WordStar MicroPro's WordStar word processing package 

runs under TurboDOS versions 1.30 and later 
without modification. Operation in banked- 
memory systems is particularly attractive, 
since WordStar works best with lots of TPA. 

Concurrent editing and printing works best 
with spooled printing. The Attention/CTRL-L 
sequence is useful for initiating de-spooled 
printing without having to exit WordStar. 

Since WordStar calls the MP/M Delay function 
(C-function 141) which is supported by the 
Turbc-FCS MPMSUP module, it is essential to 
include either an RTC driver or RTCNUL in the 
system generation; otherwise, WordStar will 
hang. 
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INDEX 

$ . DIR, 2-7 
$.DSK, 2-7 

abort intercept, 3-4, 5-10 
activate do-file (T16), 5-18 
all-inclusive lock, 4-42, 4-43 
allocate memory (T3), 5-5 
allocation block size, 2-1 
allocation map, 2-2, 5-13 
application notes, D-l 
archived file attribute, 2-9 
ASCII files, 2-3 
attention requests, 3-4 
attributes 

file, 2-9, 4-33 
interface, 2-9, 4-17, 4-18 
autoload, 1-10, 5-19 

BACKUP command, 5-25, 5-28 
banked memory, 1-3, 5-46 
base page, 1-1, 1-11 
basic console I/O, 3-1 
basic print output, 3-6 
batch processing, 1-10 
baud rate, 5-40 
BDOS 

functions, 1-4 
version, 4-14 

BIOS branch table, 1-7, 1-11 
block size, 2-1 
BOOT command, 5-25 
BREAK, 3-4 

buffer management, 2-17, 5-26 
BUFFERS command, 1-2, 5-26 

C-function 

calling sequence, 4-1 
definition, 1-4 
entrypoint, 1-11 
summary of, B-l 


capacity of disks, 2-1 
chain to prog (C47), 4-46, 4-50 
CHANGE command, 5-28 
changing media, 2-18, 5-29 
character control block, 4-52 
close file (C16), 4-18 
cold-start, 1-10 
COLDSTRT.AUT, 1-10 
comm channel 

get baud rate (T38), 5-41 
get modem status (T40), 5-43 
get comm status (T34), 5-37 
I/O, 3-5 

input (T35), 5-38 
output (T36), 5-39 
set baud rate (T37), 5-40 
set modem contrls (T39), 5-42 
command 

format, 1-8 
parsing, 1-S 
processing, 1-8 
prompt, 1-8 
sending, 5-20 
strings, 1-9 
tail, 1-8 

common memory, 1-3 
compatibility modes, 2-13, 5-15 
compute file size (C35), 4-38 
conditional 

attach list (C161), 4-69 
read queue (C138), 4-58 
write queue (C140), 4-60 
CONREM driver, 5-36 
console 
I/O, 3-1 

identification, 3-3 
input (Cl), 4-3 
output (C2), 4-4 
CP/M compatibility, 1-4, 4-14 
CPMSUP module, 4-9, 4-10, 4-27, 
4-31, 4-32, 4-40, 4-49 
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create process (Tl), 5-3 

CTRL-C, 3-4 

CTRL-L, 3-4 

CTRL-P, 3-4 

CTRL-Q, 3-4 

CTRL-S, 3-4 

current drive, 1-8 

deallocate memory (T4), 5-6 

default FCB, 1-12 

default record buffer, 1-12 

delay (C141), 4-61 

delay process (T2), 5-4 

delete fi 1 e (C19) 4-22 

delete queue (C136), 4-56 

delimiter, 4-11, 4-51 

despool mode, 5-32 

direct console I/O (C6), 4-8 

directory, 2-2 

directory formats, 2-3 

dis/enable autoload (T17), 5-19 

disk 

capacity, 2-1 
directory, 2-2 
organization, 2-2 
parameter block, 4-34 
specification table, 5-25 
dispatch (C142), 4-62 
DMA address, 4-15, 4-29 
do-file, 1-10, 5-18 
drive letter, 2-6, 2-7 

end-of-print, 5-31 
entrypoint 

C-function, 1-11 
T-function, 1-11 
warm-start, 1-11 
error handling, 2-19 
error intercept routine, 5-9 
exclusive open mode, 2-11 

FCB organization, 2-7 
FIFO file attribute, 2-9 


FIFO files, 2-15 
file 

attributes, 2-9, 4-33 
control block format, 2-7 
libraries, 2-10 
locks, 2-11 
names, 2-6, 2-7 
operations, 2-4 
organization, 2-3 
sharing, 2-10 

special ($.DIR/$.DSK), 2-7 
system, 2-1 
type, 2-7 

FIXDIR command, 5—28, 5—45 
FIXMAP command, 5-13, 5-28 
floppy disks, 2-1 
flush list buffer (T31), 5-34 
flush/free buffers (T26), 5-29 
FORMAT command, 5-25, 5-28 

get 

ALV address (C27), 4-30 
buffer params (T24),.5-27 
comm baud rate (T38), 5-41 
comm status (T34), 5-37 
console number (C153), 4-66 
console status (Cll), 4-13 

date and time (C105), 4-48 

date and time (C155), 4-67 

date and time (T10), 5-12 

disk free space (C46), 4-45 
DFB address (C31), 4-34 
I/O byte (C7), 4-9 
modem status (T40), 5-43 
R/O vector (C29), 4-32 
get/set 

despool mode (T29), 5-32 
delimiter (C110), 4-11, 4-51 
drive status (T21), 5-23 
print mode (T27), 5-30 
pcjiii ret urn code (C108) , 4-50 
user number (C32), 4-35 
global files, 2-9, 2-10, 2-14 
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hard disks, 2-1 

hashed directory format, 2-3 
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label on volume, 2-2 
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load optimization, 2-18 
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lock/unlock drive (T25), 5-28 
locks 

file, 2-11 
record, 2-12 

log-on/log-off (T14), 5-16 
logical compatibility, 2-14 

make file (C22), 4-25 
make queue (C134), 4-54 
map, 2-2, 5-13 
MASTER command, 5-36 
media changes, 2-18, 5-2S 
memory 

banked, 1-3, 5-46 
non-banked, 1-2 
organization, 1-1 
message node, 5-7, 5-8 
mixed-mode compatibility, 2-14 
modem controls, 5-42 
modem status, 5-43 
MONITOR command, A-l 
MP/M, 1-5, 2-13 
MP/M queues, 2-16 
MPMSUP module, 4-54 to 4-63, 
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file control block, 2-7 
memory, 1-1 
text files, 2-3 
output delimiter, 4-11, 4-51 

parse file name (C152), 4-64 
parsing command tail, 1-9 
partial close, 4-18 
PDR packet, 5-24 
permissive open mode, 2-11 
permissive compatibility, 2-13 
physical disk access (T22), 
5-24, 5-29 

physical disk request, 5-24 
print block (Clll), 4-52 
print mode, 5-30 
print string (C9), 4-11 
PRINTER command, 5-32 
printer control, 3-7 
printer output, 3-6 
privileged log-on, 2-10, 4-35 
program interface, 1-4 
program termination, 1-6, 4-2 

queue a print file (T30), 5-33 
queues, emulation of MP/M, 2-16 
QUEMGR module, 4-54 to 4-60 
QUEUE command, 5-33 

raw console I/O, 3-2 
raw console input (C3), 4-5 
raw console output (C4), 4-6 
read console buffer (CIO), 4-12 
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read queue (C137), 4-57 
read random (C33), 4-36 
read sequential (C20), 4-23 
read-only file attribute, 2-9 
read-only open mode, 2-11 
rebuild disk map (Til), 5-13 
receive I/P message (T6), 5-8 
record locks, 2-12 
remote console I/O (T33), 5-36 
rename file (C23), 4-26 
reorg directory (T42), 5-45 
reserved tracks, 2-2 
reset disk system (C13), 4-15 
reset drive (€37), 4-4- 
reset O/S (TO), 5-2 
return alloc info (T19), 5-21 
return current disk (C25), 4-28 
return login vector (C24), 4-27 
return phys info (T20), 5-22 

return serial nr (C107), 4-49 
return serial nr (T12), 5-14 
return version (C12), 4-14 

search for first (C17), 4-39 
search for next (C18), 4-21 
select disk (C14), 4-16 
select memory bank (T43), 5-46 
send command line (T18), 5-20 
send I/P message (T5), 5-7 
serial I/O, 3-1 
set abort address (T8), 5-10 
set buffer parms (T23), 5-26 
set comm baud rate (T37), 5-40 
set compatibility (T13), 5-15 
set date and time (C104), 4-47 
set date and time (T9), 5-31 
set DMA address (C26), 4-29 
set error address (T7), 5-9 
set file attributes (C30), 4-33 
set I/O byte (C8), 4-10 
set list (C160), 4-68 
set multi-sector (C44), 4-44 
set modern contro3s (T39) , 5-42 
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shared open mode, 2-11 
sharing files, 2-10 
signal end-of-print (T28), 5-31 
special file names, 2-7 
stacked command lines, 5-20 
stacked do-files, 5-18 
string console I/O, 3-2 
suspend compatibility, 2-14 
system reset (CO), 4-2 
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calling sequence, 5-1 
entrypoint, 1-12 
summary, C-l 
tail parsing, 1-9 
terminate (C143), 4-63 
terminating programs, 1-6, 4-2 
text files, 2-3 
transient program area (TPA), 
1-1, 1-2, 1-3, 1-8, 1-11 

unlock record (C43), 4-43 
user number, 2-6, 2-10, 4-35 
user-defined fen (T41), 5-44 
USRFCN routine, 5-44 

VERIFY command, 5-25, 5-28 
volume label, 2-2 

warm-start, 1-7, 1-10, 4-2 
WARMSTRT.AUT, 1-10, 5-19 
wild-cards, 2-3, 2-6, 4-19, 
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write protect disk (C28), 4-31 
write queue (C139), 4-59 
write random (C34), 4-37 
write random w/zero-fill (C40), 
4-41 

write sequential (C21), 4-24 
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